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Overview of the Zmacs Manual 



Scope 



Organization 



The Zmacs Manual is primarily a reference manual and is 
intended for all users of Zmacs on the Lisp Machine. It contains 
both conceptual overview and reference material that together 
describe the Zmacs editor. We assume that you have already read 
the User's Guide to Symbolics Computers. 



The first three chapters contain introductory material for users 
who are unfamiliar with Zmacs concepts. Experienced users can 
skim the remaining chapters, which are organized according to 
editing function, and use them as reference material. 

"Introduction" gives an overview of Zmacs and describes Zmacs 
documentation conventions in this manual. 

"Getting Started" introduces basic Zmacs concepts and commands, 
such as how to enter text, move the cursor, and make simple 
corrections. 

"Getting Help" describes ways to get out of trouble and how to 
get Zmacs information during editing. 

"Moving the Cursor" includes descriptions of both mouse and 
keyboard motion commands. 

"Deleting and Transposing Text" explains Zmacs deletion and text 
retrieval concepts, as well as the ways to delete and transpose 
text. 

"Working With Regions" tells how to manipulate blocks of text. 

"Searching, Replacing, and Sorting" describes the commands for 
locating and replacing character strings in one or many files. 

"Manipulating Buffers and Files" gives more information on 
manipulating blocks of text, inserting files, keeping track of 
ever3rthing, and editing your directory. 

"Setting the Major Mode" documents the major editing modes and 
their characteristics. 

"Changing Case and Indentation" includes many commands for 
changing code, comments, or text to uppercase or lowercase, as 
well as commands for handling white space, indentation, and 
formatting. 

"Editing Lisp Programs" the ways in which Zmacs is tailored for 
use in writing and editing programs in Lisp. 

"Customizing the Zmacs Environment" describes how to fine tune 
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your Zmacs environment using modes to set it up, keyboard 
macros to perform special editing tasks, binding keys to the 
commands of your choice, setting Zmacs variables to alter your 
standard system aults, and saving the customized environment in 
init files. 

Appendix A summarizes Zmacs help commands according to the 
context in which they are available. 
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Overview 



Zmacs, the Lisp Machine editor, is built on a large and powerful 
system of text-manipulation functions and data structures, called 
Zwei. 

Zwei is not an editor itself, but rather a system on which other 
text editors are implemented. For example, in addition to Zmacs, 
the Zmail mail reading system also uses Zwei functions to allow 
editing of a mail message as it is being composed or after it has 
been received. The subsystems that are established upon Zwei 
are: 

• Zmacs, the editor that manipulates text in files 

• Dired, the editor that manipulates directories represented as 
text in files 

• Zmail, the editor that manipulates text in mailboxes 

• Converse, the editor that manipulates text in messages 

Since these subsystems share Zwei in the djniamically linked Lisp 
environment, many of the commands available as Zmacs 
commands are available in other editing contexts as well. 

In this manual, we discuss Zmacs commands in the context of 
Zmacs only. We also describe Dired, the directory editor, since it 
is used within Zmacs. 



Commands 



Zmacs commands are Lisp functions that perform the editing 
work. Every Zmacs command has a name, and many commands 
are bound to keys. When a command is bound to a keystroke 
combination, you invoke it by pressing those keys. For example, 
the Forward Word command is invoked by typing the keystroke 
n~F. When a command is not bound to a set of keystrokes, Zmacs 
calls it an extended command and you invoke it using its name 
preceded by n-X. For example, the command View Mail, an 
extended command, is invoked by View Mail n-X. 

Command tables assign keystrokes and names to commands. Each 
time you press a key, Zmacs looks up the function associated with 
that key. For ordinary characters, the function corn-standard, in 
the standard command table, inserts the character once. 
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Keystrokes 

A keystroke has a character component and a modifier component, 
and is performed by pressing a primary key (alphanumeric), 
possibly while holding down a shift key or a group of shift keys. 
The primary key held down with either the SHIFT or SYMBOL keys 
determines the character part of a keystroke. Whether you hold 
down the other shift keys, CONTROL, METfl, HYPER, and SUPER, 
determines the modifier part of the keystroke. 

In general, commands that begin with a CONTROL (c-) key 
modifier operate on single characters, commands that begin with 
a METfl (n-) key modifier operate on words, sentences, paragraphs, 
and regions, and commands that begin with a CONTROL METfl 
(c-n-) modifier operate on Lisp code. 

Prefix character commands consist of more than one keystroke per 
command. For example, to invoke the command c-X F, you first 
type the prefix character c-X and then the primary key F. Prefix 
character commands are not case-sensitive - that is, Zmacs 
converts a lowercase character following a prefix character 
command (like c-X) to uppercase. For example, c-X f is 
equivalent to c-X F. 

Zmacs commands are self-delimiting. Unless otherwise specified, 
you do not need to type a carriage return or other terminating 
character to finish typing a command. 

Extended Commands 

Extended commands extend the range of commands past the one- 
or-two-keystroke limitation. You invoke Zmacs extended 
commands by name using the n-X command: 

n-X Extended Command 

Prompts for the name of a Zmacs command and executes that 
command. 

Command completion is provided. See the section "Completion for 
Extended Commands (n-X Commands)" in User's Guide to 
Symbolics Computers. 

Command Tables 

There is always a currently active command table (comtab). 
When you invoke a command, Zmacs looks it up in the associated 
command table, checks to see if it is valid in the current context, 
and performs the function. Zmacs uses many comtabs, including 
the standard comtab, a comtab for commands that begin with the 
c-X prefix, and a comtab for reading pathnames in the minibuffer. 
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Many commands have no meaning outside their own limited 
context. Sometimes you might get a message or see online 
documentation about a command that says 

Not available in current context. Those commands that are not 
accessible via a keystroke and not accessible via n-X are likely to 
be commands that do not work in the current context. For 
example, a command that is part of Dired is only available on a 
key when you are in Dired. 

You can invoke a command that is not available in the current 
comtab with the c-n-X command. c-n-X works like n-X: you 
press the keys and then type the command name in the 
minibuffer. This is primarily intended for debugging new editor 
commands that have not yet been installed on any key. Using 
c-n-X to invoke a command that is not in the current comtab 
because it works only in some other context is a sure way to get 
into trouble. 

c-n-X Any Extended Command 

Prompts for the name of a Zmacs command and executes that 
command. 



Command completion is provided. 
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Zmacs Notation 
Conventions and Examples 

The word current, when describing a word, line, paragraph, page, 
or any Zmacs-recognizable piece of text, refers to the text that 
currently contains (or immediately follows) the cursor. 

The invocation of a command shows exactly what keys you must 
press to invoke, or call, a command. We use the following format 
to describe Zmacs commands: 

invocation Name 

alternate invocation 
alternate invocation 

Formal description of command 

Since each extended (n-X) command contains its name as part of 
its invocation, we do not repeat the name again on that line. 

Example 1 of Zmacs 
Notation Conventions 

n-> Goto End 

Moves point to the end of the buffer. 

With a numeric argument n between and 10, moves point to a 
place n/10 of the way from the end of the buffer to the beginning. 

(The n-> command goes to the end of the buffer - its name is 
Goto End.) 

Example 2 of Zmacs 
Notation Conventions 

Dired (n-H) 

Prompts for the name of a directory to edit with Dired. 

(The Dired (n-X) command is an extended command that enters 
the directory editor.) 
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Example 3 of Zmacs 
Notation Conventions 

n-M Back To Indentation 

c-n-M 

n-RETURM 

c-n-RETURN 

Positions point before the first nonblank character on the current 
line. 

(Back to Indentation has several possible invocations that all move 
back to the first nonblank character on the line.) 
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Introduction to 
Entering Zmacs 

You can enter, or invoke, the editor in several ways: Press 
SELECT E, use the mouse, or run either the function ed or the 
function zweiiedit-functions. You can also use the command 
Select Activity, specifying either Zmacs or Editor as its argument. 



Entering Zmacs 
with SELECT E 



Entering Zmacs 
with the Mouse 



Entering Zmacs 
with ed 



You can invoke the editor by pressing the SELECT key and then 
the letter E: 

• If you have already been in the editor since booting the 
machine, Zmacs returns you to the same place in the same 
buffer that you last used. 

• If this is the first time you are entering Zmacs since booting 
the machine, Zmacs puts you in an empty buffer named 
*Buffer-1*. 

SELECT E enters or returns you to the editor from anyplace in the 
system, not just when you are talking to Lisp. 



You can invoke the editor using the mouse. 

Summon a System menu by clicking right twice [(R2)]. Then 
click left on the Edit option [Edit (L)], which puts you into a 
Zmacs buffer. As for SELECT E, if you are returning to the editor 
Zmacs puts you back at the same place in the same buffer, and if 
you are entering Zmacs for the first time it puts you in an empty 
buffer. 



The Lisp function ed enters Zmacs from a Lisp Listener. See the 
function ed in User's Guide to Symbolics Computers. 

When reentering Zmacs within a login session, ed enters the 
editor, preserving its state as it was when you left. When 
entering Zmacs for the first time during a login session, ed 
initializes Zmacs and creates an empty buffer. 

arg can have these values. 
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(el "f/,u 



Value 
t 

Pathname or string 

I 

Defined symbol 



The symbol zwei: reload 



Description 

The ed function enters the editor, 
creates an empty buffer, and selects 
it. 

The ed function enters the editor and 
finds or creates a buffer with the 
specified file in it. 

The editor tries to find the source 
definition of that sjmibol for you to 
edit. A defined symbol can be, for 
example, a function, macro, variable, 
flavor, or system. 

The system reinitializes the editor. 
This destroys all existing buffers, so 
use this only if you have to. 



Entering Zmacs 

with zwei: edit-f unctions 

The Lisp function zwei:edit-functions also enters Zmacs from a 

Lisp Listener. 

zwei:edit-functions Function 

zwei: edit-f unctions is like ed in that inside the editor process it 
throws you back into the editor, whereas from another process it 
just sends a message to the editor and selects the editor's 
window. zwei:edit-fiinctions gives spec-list to the editor in the 
same way that Edit Callers and similar editor commands would. 
See the section "The Zmacs Edit Callers Commands", page 239. 

This command is useful when you have collected the names of 
things that you need to change, for example, using some program 
to generate the list, spec-list is a list of definitions; these are 
either function specs (if the definitions are functions) or sjrmbols. 

Zmacs sorts the list into an appropriate order, putting definitions 
from the same file together, and creates a support buffer called 
*Function-Specs-to-Edit-7i«. It selects the editor buffer 
containing the first definition in the list. 
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Introduction to 
Zmacs Help 



Zmacs has many features that provide information about Zmacs 
commands, existing code, buffers, and files. Two features are 
generally useful: the HELP key and completion. See the section 
"Getting Help in Zmacs", page 47. 



Introduction to HELP 

Pressing the HELP key in a Zmacs editing window gives 
information about Zmacs commands and variables. For 
descriptions of Zmacs variables: See the section "How to Specify 
Zmacs Variable Settings", page 269. The kind of information it 
displays depends on the key you press after HELP. 



HELP ? 
HELP R 



HELP C 



HELP D 



HELP L 



HELP U 



HELP U 



HELP U 



HELP SPACE 



Displays a summary of HELP options. 

Displays names, key bindings, and brief 
descriptions of commands if their names or the 
first lines of their help documentation contain a 
string you specify. The A refers to n-X 
Apropos, the command equivalent. If you enter 
the command with a numeric argument, only 
the names of the commands are searched for 
the string, and not the help documentation. 

Displays the name and description of a 
command bound to a key you specify. 

Displays documentation for a command whose 
name you specify. 

Displays a listing of the last 60 keys you 
pressed. 

Offers to undo the last major Zmacs operation, 
such as sorting or filling, when possible. 

Displays the names and values of Zmacs 
variables whose names contain a string you 
specify. For descriptions of Zmacs variables: 
See the section "How to Specify Zmacs Variable 
Settings", page 269. 

Displays the key binding for a command you 
specify. (The W refers to where.) 

Repeats the last HELP command. 
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Introduction to Completion 

Some Zmacs operations require you to provide names - for 
example, names of extended commands, Lisp objects, buffers, or 
files. Often you do not have to type all the characters of a name; 
Zmacs offers completion over some names. When completion is 
available, the word Completion appears in parentheses above the 
right side of the minibuffer. 

You can request completion when you have typed enough 
characters to specify a unique word or name. For extended 
commands and most other names, completion works on initial 
substrings of each word. For example, n-X c SPACE b is 
sufficient to specify the extended command Compile Buffer. 
SPRCE, COMPLETE, RETURN, and END complete names in different 
ways. Press HELP or click right once, [(R)], on the editor window 
or minibuffer to list possible completions for the characters you 
have typed, c-/ displays every command that contains the 
substring. 

SPRCE Completes words up to the current word. 

HELP or C-? Displays possible completions in the t3^eout 

area. 

[(R)] Pops up a menu of possible completions. 

c-/ Runs Apropos for each of the partially typed 

words in the name. 

COMPLETE Completes as much as possible. This could be 

the full name. 

RETURN or END Confirms the name if possible, whether or not 
you have seen the full name. 



Introduction to Yanking 

Yanking is getting back previously killed text or previously typed 
minibuffer commands. Using a few keystrokes, you can retrieve 
editing commands you have previously typed or restore any piece 
of text you have previously killed. Popping is moving through the 
history of previous commands or killed text. 

To get back the last piece of text killed, press c-Y. To work your 
way back through the kill history, press n-Y repeatedly. 

To get back the last command typed, press c-n-Y. To work your 
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way back through the command history, press n-Y repeatedly. 
This technique works only on editor commands that use the 
minibuffer in some way. Commands like c-M or c-P are not kept 
in the history. 

You can also select items from the entire kill history or command 
history, or search a part of these histories using string-matching. 

Here are the commands for yanking in the kill history: 

c-Y Yanks the first element in the kill history. 

n-Y After c-Y, n-Y yanks the previous element in 

the kill history. Subsequent n-Ys move down 
the kill history. 

c-0 c-Y Displays the elements of the kill history. You 

can click left on any item in the history to 
insert it in your buffer. Only the first 25 
elements of the history are shown. Click left 
on {N more elements in history.) to display 
the rest of the history. 

c-sh-Y Yanks the first element in the kill history that 

matches a string you supply. 

n-sh-Y After c-sh-Y, n-sh-Y yanks a previous element 

in the kill history that matches the string you 
supplied. Subsequent n-sh-Y s move down the 
kill history matching the same string. If 
pressed after a c-Y, n-sh-Y prompts for a 
string to match. 

c-0 c-sh-Y Displays the elements of the kill history that 

match a string you supply. You can click left 
on any item in the history to insert it in your 
buffer. Only the first 25 matching elements of 
the history are shown. Click left on (N more 
elements in history.) to display the rest of the 
matching history. 

Here are the commands for yanking in the command history: 

c-n-Y Yanks the first element in the command 

history. 

n-Y After c-n-Y, yanks the previous element in the 

command history. Subsequent n-Ys move down 
the command history. 
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c-0 c-n-Y Displays the elements of the command history 

You can click left on any item in the history to 
execute that command. Only the first 25 
elements in the history are shown. Click left 
on (N more elements in history.) to display 
the rest of the history. 

c-n-sh-Y Yanks the first element in the command history 

that matches a string you supply. 

n-sh-Y After c-n-sh-Y, n-sh-Y yanks a previous 

element in the command history that matches 
the string you supplied. Subsequent n-sh-Y s 
move down the command history matching the 
same string. If pressed after a c-n-Y, n-sh-Y 
prompts for a string to match. 

c-0 c-n-sh-Y Displays the elements of the command history 
that match a string you supply. You can click 
left on any item in the history to execute that 
command. Only the first 25 elements in the 
history are shown. Click left on (N more 
elements in history.) to display the rest of the 
history. 

For complete descriptions of killing and yanking: See the section 
"Deleting and Transposing Text in Zmacs", page 83. 
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Introduction to the 
Organization of 
the Screen 

Zmacs divides its window into several areas: the editor window, 
the echo area, and the mode hne, each of which contains its own 
type of information. 

Zmacs Editor Window 

The biggest area, the editor window y shows the text you are 
editing. You can edit several different items at once with Zmacs; 
each item is edited in a separate editing environment called a 
buffer. 

Editor Window's Buffer 

Zmacs gives every buffer a name. At any time you are editing 
only one of them, the selected buffer. When we speak of what 
some command does to "the buffer", we are talking about the 
currently selected buffer. Multiple buffers in Zmacs make it easy 
to switch among several files; the mode line tells you which one 
you are editing. 

Editor Window's 

Cursor and Point 

The small blinking rectangle, the cursor, usually appears 
somewhere within the buffer, showing the position of point, the 
location at which editing takes place. Although the cursor covers 
a single character, we consider point to be at the left edge of the 
cursor, between the character the cursor is blinking on and the 
previous character. 

Editor Window's Typeout 

When you request some other information from Zmacs (for 
example, if you ask for help or a listing of a file directory), Zmacs 
needs room to display this type of information. It prints this 
typeout in a typeout window (at the top of the editor window), 
which temporarily overlays the text in the editor window, using as 
much room as it needs. 

Since the t3T3eout is not part of the file you are editing, Zmacs 
delineates it from the editor buffer by drawing a line across the 
window between them (if both are present). The tj^Deout window 
goes away if you type any command; if you want to make it go 
away immediately but not do anything else, you can press SPACE. 
The cursor, which appears at the end of the typeout, then moves 
back to its original location in the buffer. 
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Zmacs Echo Area 

A few lines at the bottom of the screen make up what is called 
the echo area. Echoing means displa3^g the commands that you 
type, Zmacs commands are usually not echoed at all, but if you 
pause in the middle of a multicharacter command, then all the 
characters (including numeric arguments and prefixes) typed so 
far are echoed. This is intended to prompt you for the rest of the 
command. The rest of the command is echoed, too, as you type 
it. This behavior is designed to give confident users optimum 
response, while giving hesitant users maximum feedback. 

Echo Area's Minibuffer 

Many Zmacs commands prompt you for addition£il information. 
This prompting happens in a small window within the echo area 
called the minibuffer. 

When Zmacs prompts you, the cursor in the main editing window 
stops blinking and a blinking cursor appears in the minibuffer. 
Over the minibuffer, in the Zmacs mode line, some prompting text 
appears, indicating what information Zmacs is prompting you for. 

When you type a response to the prompt, that response is inserted 
in the minibuffer. You can edit text in the minibuffer using the 
same Zmacs commands used in the main Zmacs window. 

When you are done typing (and possibly editing) a response to the 
prompt, the RETURN key finishes your response. 

Zmacs Mode Line 

The line above the echo area is known as the mode line. It is the 
line that usually starts with ZMACS (Fundamental). Its purpose is 
to display information about the current buffer. 

The mode line consists of: 

• The name of the major mode 

• [The name of the minor mode(s), if any 

• The name of the buffer 

• The version number of the file 

• The status of the buffer 

• A message telling whether the buffer contents extend above 
and/or below the screen 

The mode line has this format: 



20 

Text Editing and Processing July 1986 



Organization of the Screen, conrd. 



ZMACS (major-mode minor-mode(s)) buffer (version) buffer-status 
[position-flag] 

Mode Line's Major-mode 

major-mode is always the name of the major mode you are in. At 
any time, Zmacs is in one and only one of its possible major 
modes. The major modes available include: 

• Fundamental mode (which Zmacs starts out in) 

• Text mode 

• Lisp mode 

• MACSYMA mode 

For full details about all the major modes, how they differ, and 
how to select one: See the section "Setting the Zmacs Major 
Mode", page 175. 

Mode Line's Minor-mode 

minor-mode is a list of the minor modes that are turned on at the 
moment. For example: 

Fill Auto Fill Mode 

Electric Shift-lock Electric Shift Lock Mode 

Abbrev Word Abbrev Mode 

Overwrite Overwrite Mode 

For more information: See the section "Built-in Customization 
Using Zmacs Minor Modes", page 253. 

Mode Line's Buffer 

buffer is the neime of the workspace that holds the text you are 
editing. A buffer can be named in one of two ways: 

• By Zmacs, with a name that corresponds to the existing file 
that it contains or with its standard name for an empty buffer 

• By you, with any name you like 

When a buffer contains a file, the buffer name is the pathname of 
that file, rearranged with the file name first and the host and 
directory at the end. For a description of pathname components: 
See the section "Pathnames" in Reference Guide to Streams, Files, 
and I/O. When a buffer does not contain a file, the buffer name 
is a string. 
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Buffers that do not contain files are empty, newly created, or 
temporary buffers. When Zmacs creates and names a buffer, that 
name begins and ends with an asterisk. When you create and 
name a buffer, on the other hand, its name is of your choosing. 

When you first start up and enter Zmacs, your buffer is either: 

• An empty buffer called *Buffer-1*, which is the only one that 
exists when Zmacs starts up 



• 



A buffer containing an existing file, which Zmacs appropriately 
calls by its name 

For information on multiple buffers: See the section 
"Manipulating Buffers and Files in Zmacs", page 129. 

Mode Line's Version 

(version) is the version number most recently visited or saved. 
The mode line does not display any version number if the file is 
on a file system that does not support version numbers, such as 
UNIX. 

Mode Line's Buffer-status 

If the mode line displays *, then changes have been made in the 
buffer that have not been saved in the file. If the buffer has not 
been changed since it was read in or saved, the mode line does 
not display a asterisk. 

Mode Line's Position-flag 

When the mode line displays the message [More above], then your 
screen shows the end of your buffer contents; when the mode line 
shows [More below], then your screen shows the beginning of your 
buffer contents. When it says [More above and below], then the 
buffer contents extend above and below the part that the screen 
displays. When the display shows the entire buffer contents, this 
message does not appear at all. 

Mode Line Example 

ZMACS (Text) text. text /dess/doc/books/ VAX: * [More above and 
below] 

In this sample mode line, we are in Zmacs Text Mode, editing a 
file named text. text, which resides in the directory /dess/doc/books 
on the host named VAX. The file has been changed since we last 
saved it (indicated by the *), and the file contents extend above 
and below the portion that Zmacs displays on the screen. 
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Introduction to 
Inserting Text 

To insert new text an5rwhere in the buffer, position the cursor at 
the place you want the new text to go and tjrpe the new text. 
Zmacs always inserts characters at the cursor. The text to the 
right of the cursor is pushed along ahead of the text being 
inserted. 

Inserting Characters 

When you type in new text, you are actually issuing Zmacs 
commands. Ordinary printing characters are called self-inserting 
because when you type one, it inserts itself into the text in your 
buffer. 

You can give numeric arguments to the keystrokes that insert 
printing characters into the buffer; Zmacs interprets these 
arguments as repeat counts. See the section "Numeric 
Arguments", page 26. 

Example: c-80 * inserts a line of 80 asterisks at the cursor. 

Starting a New Line 

Newline characters delimit lines of text. They have no visible 
printed form, but are present at each line break. You can break 
one line into two lines by inserting a newline (pressing RETURN) 
where desired. Similarly, you can merge two lines into one by 
deleting the intervening newline. 

Correcting Typos 

To correct text you have just inserted, use the RUBOUT key. 
RUBOUT deletes the character before the cursor (not the one over 
which the cursor is positioned; that is the character after the 
cursor). The cursor and the rest of that line move to the left. 

When given a numeric argument, RUBOUT saves the succession of 
deleted characters. 

Example: c-20 RUBOUT kills the previous 20 characters and saves 
them together. 

See the section "Deleting Vs. Killing Text", page 84. 

When the cursor is positioned on the first character on a line and 
you press RUBOUT, the preceding newline character is deleted and 
Zmacs appends the text on that line to the end of the previous 
line. 
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Wrapping Lines 

When you add too many characters to one line without breaking it 
with a RETURN, the Une grows to occupy two (or more) Unes on 
the screen, with an exclamation point at the extreme right 
margin of all but the last of them. The ! means that the 
following screen line is not really a distinct line in the file, but 
just the continuation of a line too long to fit the screen. 

Inserting 

Formatting Characters 

You can insert most characters directly into the buffer by simply 
typing them, but other characters act as editing commands and do 
not insert themselves. If you need to insert a character that is 
normally a command (for example, TAB or RUBOUT), use the c-Q 
(Quoted Insert) command first to tell Zmacs to insert the 
following character into the buffer literally. c-Q prompts in the 
echo area for the character to be inserted and inserts it into the 
text. 
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Overview of 
Numeric Arguments 

Many Zmacs commands take numeric arguments, which you t5T)e 
before the main command keystroke. Specify a numeric argument 
by pressing any combination of any of the modifier keys (c-, n-, 
S-, or h-) with the number. This way, you can type sequences of 
commands more easily without frequently alternating keys. 

Numeric arguments to commands appear in the echo area when 
you do not type the command immediately. With no delay, the 
argument does not appear. 

In general, use negative arguments to tell a command to move or 
act backwards. You can specify a negative argument by pressing 
any modifier key with the minus sign followed by the number. 
Most commands treat a numeric argument consisting of just a 
minus sign the same as -1. 

Example of 
Numeric Arguments 

c-F is the command to move the cursor forward one character. 

c-3 c-5 c-F moves point forward 35 characters; 

c — c-3 c-5 c-F moves point backward 35 characters. 

Throughout this manual, instead of writing out c-4 c-5 c-F or 
r»-4 n-5 n-B, we usually abbreviate to c-45F or n-45B. 

Defaults to 
Numeric Arguments 

Many commands have default numeric arguments. This means 
that in the absence of a numeric argument, the command behaves 
as if the default argument were given. Most commands have a 
default argument of 1. This includes all the commands that 
interpret numeric arguments as repeat counts. Some commands 
have a different default and still others have no default: their 
behavior in the absence of a numeric argument is different from 
their behavior with a numeric argument. 

c-U Quadruple Numeric Arg 

This special command prefixes other commands, usually 
representing a numeric argument of 4. You can repeat c-U; it 
multiplies the numeric argument by 4 each time. For example, 
c-U c-U c-F moves point forward 16 characters. Sometimes 
instead of representing a numeric argument of 4, c-U alters the 
action of a command slightly; for example, when used with the 
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command Set Pop Mark, c-U takes different actions with the 
mark. (For a description of the Set Pop Mark command: See the 
section "Working with Regions in Zmacs", page 99.) 
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Description of 
Moving the Cursor 

To do more than insert characters, you have to know how to move 
the cursor. 

For complete descriptions of the commands summarized here and 
other cursor-moving commands: See the section "Moving the 
Cursor in Zmacs", page 63. 

Summary of 
Moving the Cursor 

c-fl Beginning of Line 

Moves to the beginning of the hne. 

c-E End of Line 

Moves to the end of the Une. 

c-F Forward 

Moves forward one character. 

c-B Backward 

Moves backward one character. 

n-F Forward Word 

Moves forward one word. 

n-B Backward Word 

Moves backward one word. 

n-E Forward Sentence 

Moves to the end of the sentence in text mode. 

n-R Backward Sentence 

Moves to the beginning of the sentence in text mode. 

c-N Down Real Line 

Moves down one line. 

c-P Up Real Line 

Moves up one line. 

n-3 Forward Paragraph 

Moves to the start of the next paragraph. 

n-[ Backward Paragraph 

Moves to the start of the current (or last) paragraph. 

c-X ] Next Page 

Moves to the next page. 

c-X C Previous Page 

Moves to the previous page. 
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c-y, SCROLL Next Screen 

Moves down to display the next screenful of text. 

n-U, n-SCROLL Previous Screen 

Moves up to display the previous screenful of text. 

n-< Goto Beginning 

Moves to the beginning of the buffer. 

n-> Goto End 

Moves to the end of the buffer. 
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Description of 
Erasing Teart 



Most commands that erase text from the buffer save it so that 
you can get it back if you change your mind, or move or copy it 
to other parts of the buffer. These commands are known as kill 
commands. The rest of the commands that erase text do not save 
it; they are known as delete commands. The delete commands 
include c-D and RUBOUT, which delete only one character at a 
time, and those commands that delete only spaces or line 
separators. (However, when given a numeric argument, c-D and 
RUBOUT do save that sequence of deleted characters on the kill 
ring.) Commands that can destroy significant amounts of 
information generally kill. The commands' names and individual 
descriptions use the words "kill" and "delete" to say which they 
do. 

If you issue a kill command by mistake, you can retrieve the text 
with c-Y, the Yank command. For details on killing and 
retrieving text: See the section "Working with Regions in 
Zmacs", page 99. 



Summary of 
Erasing Text 



c-D 

Deletes the character after point. 

RUBOUT 

Deletes the character before point. 

n-D 

Kills forward one word. 

n-RUBOUT 

Kills backward one word. 

n-K 

Kills forward one sentence. 

c-H RUBOUT 

Kills backward one sentence. 

c-K 

Kills to the end of the line or kills an end of line 

c-W 

Kills region (from point to mark). 



c-n-K 

Kills forward over exactly one Lisp expression 



Delete Forward 

Rubout 

Kill Word 

Backward Kill Word 

Kill Sentence 

Backward Kill Sentence 

Kill Line 

Kill Region 

Kill Sexp 
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c-n-RUBOUT Backward Kill Sexp 

Kills backward over exactly one Lisp expression. 

n-\ Delete Horizontal Space 

Deletes any spaces or tabs around point. 

c-X c-0 Delete Blank Lines 

Deletes any blank lines following the end of the current line. 

n-^ Delete Indentation 

Deletes RETURN and any indentation at front of line. 
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Description 



You do all your text editing in Zmacs buffers, which are 
temporary workspaces that can hold text. To keep any text 
permanently you must put it in a file. Files store data for any 
length of time. 

To edit the contents of a file using Zmacs, you create a buffer 
and copy the file contents into it. To add text to the end of the 
buffer, move point to the end of the buffer and type the new text. 
Editing proceeds in the buffer, not in the file. The file remains 
unchanged until you explicitly write the modified buffer contents 
to the file. 

If you create multiple buffers, Zmacs keeps track of which files 
you are editing in which buffers. This association allows you to 
use completion to switch among buffers while you are editing 
them; you do not have to type the file name more than once. 
Zmacs always displays the name of the file you are currently 
editing. 

The information in this section allows you to find or create and 
save a file. For complete information on buffers and fUes: See 
the section "Manipulating Buffers and Files in Zmacs", page 129. 



Summary 



c-X c-F 

Reads the specified file into a buffer. 

c~X c-S 

Saves out the changes to the current file. 

c-X B 

Selects the specified buffer. 

c-X c-N 

Writes out the buffer to the specified file. 



Find File 

Save File 

Select Buffer 

Write File 



Creating a Buffer 

Zmacs creates your initial buffer when you first enter the editor. 
To create other buffers, use c-X B, Select Buffer, to create an 
empty buffer or c-X c-F, Find File, to create either an empty 
buffer or a buffer containing a file. 

c-X B prompts for the name of the buffer to which you want to 
go. Type the buffer name and RETURN. If the buffer exists, 
Zmacs switches to that buffer and displays it on the screen. If 
the buffer does not already exist, Zmacs offers to let you create it 
by terminating the buffer name with c-RETURN. When you create 
a new (empty) buffer, the display is blank. 
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The other way to create another buffer is c-X c-F, Find File. 
(c-H c-F) is described in detail in "Editing Existing Files". c-H 
c-F prompts for the name of a file, terminated by RETURN. 

When you type c-X c-F for the first time in a Zmacs session, 
Zmacs offers you, as a default file name, an empty file (with the 
Lisp suffix native to your host computer) in your home directory 
on your host computer. For example: 



System 


Empty Bi 


iffer Name 


Lisp Machine 


foo.lisp 




UNIX 
VMS 


foo.l 
foo.lsp 





Base and Syntax Default Settings for Lisp 



When you read a file that has a Lisp file type into the buffer, if 
that file does not begin with an attribute line containing Base and 
Syntax attributes that the file "has neither a Base nor a Syntax 
attribute" and announces that it will use the defaults. Base 10 
and Zetalisp. See the section "Buffer and File Attributes in 
Zmacs", page 155. 



Buffer Contents with c-X c-F 



The first time you use c-X c-F, you can create an empty buffer 
using the Zmacs default file name, create an empty buffer using a 
name that you specify, or create a buffer containing an existing 
file: 

• To create an empty buffer with the initial default file name as 
the one Zmacs associates with your buffer, press RETURN. 

• To create a new empty buffer, respond with any name. Zmacs 
switches to an empty buffer, gives the buffer the new name, 
and displays (New File) in the echo area. 

• To create a new buffer containing some file, respond to the 
prompt with the name of that file. Zmacs switches to an empty 
buffer, reads that file in, and names the buffer appropriately. 
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Saving a File 

Once you have the file in your buffer, you can make changes and 
then save the file with c-X c-S, the Save File command. This 
makes the changes permanent and actually changes the file. 
Until then, the changes are only inside your Zmacs buffer and the 
file itself is not really changed. 

Creating a File 

The first time you save or write the buffer, Zmacs creates the 
new file. You can create a new file with c-X c-S. Since a new 
file does not have a name associated with it yet, Zmacs asks for a 
name for the new file. It offers a default pathname, which is the 
name of the buffer. If you wish to save the file out to the default 
pathname, simply type a RETURN in response to the prompt. 

If you wish to save the buffer in another file, provide that name 
as your response. Completion is offered to simplify your response. 

You can also write the buffer out with c-X c-W, Write File. 
Zmacs prompts in the minibuffer for the name of the place you 
want to write the buffer's contents. c-X c-W also offers a default 
pathname, in this case, the name you supplied with c-X c-F. 

Editing Existing Files 

To tell Zmacs to edit text in a file, use c-X c-F, the Find File 
command, and give Zmacs a file name. You can enter the 
pathname of any file on any host that is reachable by network 
connections from your Lisp Machine. If the file already exists, 
Zmacs locates the file and reads it into your buffer. 
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Introduction 

The extended commands Format Region (n-X), Format Buffer 
(n-X), and Format File (n-X) display text in a formatted style 
using formatting instructions that you embed in the text. You 
can send the formatted text to a supported printer (LGPl, LGP2, 
or DMPl) by giving the Format command a numeric argument. 
This prompts for an output device. 

Page numbers are included by default on hardcopy output. You 
can turn off page-numbering with a numeric argument of 0. 

Zmacs also supports a number of commands for using character 
styles which allow text formatting of a somewhat different sort. 
See the section "Character Styles in Zmacs". 

Producing 
Formatted Text 

Producing formatted text requires two steps: 

1. Entering the text and formatting instructions 

2. Formatting that text with one of the Zmacs formatting 
commands 

First you use the Zmacs editor to enter the text and embed 
formatting instructions, which can be environments and 
commands. These instructions format the text by, for example, 
specifying fonts, creating buUetted lists, and inserting headings. 

For example, to specify that you want to italicize a group of 
words, like the title of a book, use the italicize environment. To 
emphasize a word, you might use the boldface environment. 

This text: 

@i (Gone With the Wind), by Margaret Mitchell, is a eb(great) book, 

produces this, when formatted: 

Gone With the Wind, by Margaret Mitchell, is a great book. 

Formatting instructions all begin with an @. The "i" tells the 
formatter that you want the italicize environment, and the 
parentheses {delimiters) enclose the text within that environment. 
Other valid delimiters can be (), [], o, {}, "", ", or ". 

How to Create an Environment 

Environments can be either short form, Si (italicize this), or 
long form, where the commands (§>begin(i) and <§>end(i) act as 
delimiters for the text that they enclose. For example, to italicize 
an entire passage: 



36 

Text Editing and Processing July 1986 

Zmacs Commands for Formatting Text contu 



@begin(i) 

Environments can be either short form or long form. The long 

form uses the commands @@begin and @@end to act as delimiters 

for the text that they enclose. 

@end(i) 

produces this: 

Environments can be either short form or long form. The long 
form uses the commands @begin and @end to act as delimiters for 
the text that they enclose. 

(The @s inside the environment must be doubled so the formatter 
does not interpret them as format commands.) 

The following environment enumerates^ that is, numbers 
sequentially each separate line of text within it: 

Sbegi n (enumerate) 
Paragraph 1 

Paragraph 2 

Paragraph 3 
Send (enumerate) 

produces the following output: 

1. Paragraph 1 

2. Paragraph 2 

3. Paragraph 3 

Basic Teid; 

Formatting Environments 

Environments can be either filled or unfilled: 

Filled Fills each output line to capacity within the 

limits of the display. 

Unfilled Keeps output lines exactly as you entered them, 

as in an example. 

Basic formatting environments are: 

b Displays enclosed text in boldface. 

c Displays enclosed text in capital letters. 
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center 
description 

display 

enumerate 
equation 

example 

figure 

flushleft 

flushright 
format 



fuUpagefigure 



fuUpagetable 



g 
heading 



Centers each line in an unfilled environment. 

Outdents paragraphs with single spacing and 
wider margins in a filled environment. 

Displays enclosed text in Roman (default) 
typeface and widens both margins in an unfilled 
environment. 

Moves the left margin to the right, displaying a 
number in the left margin for each paragraph. 

Displays equations in an unfilled environment 
using fixed-width typeface. It widens both 
margins. 

Displays examples in an unfilled environment 
using fixed-width typeface. It widens both 
margins. 

Displays figures in an unfilled environment 
using Roman (default) typeface with no changes 
to the margins. 

Displays unfilled text aligned at the left 
margin. It recognizes and includes leading 
spaces. 

Displays unfilled text aligned at the right 
margin. It ignores trailing spaces. 

Displays enclosed text in an unfilled 
environment using Roman (default) typeface 
with no changes to the margins. Any 
horizontal alignment that is needed should be 
done with tabbing commands (for example, (a)\ 
and (§)>). 

Displays figures in an unfilled environment 
using Roman (default) typeface with no changes 
to the margins. 

Displays tables in an unfilled environment using 
Roman (default) typeface with no changes to 
the margins. 

Displays enclosed text in Greek typeface. 

Centers each line in boldface type in an unfilled 
environment. 
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itemize 

majorheading 

multiple 

outputexample 



quotation 



subheading 
table 

text 
verbatim 



Displays enclosed text in italics. 

Moves the left margin to the right, displa3n[ng a 
bullet in the left margin for each paragraph. 

Centers each line in boldface type in an unfilled 
environment. 

Keeps enclosed text together as a single item 
within itemize, enumerate, or description 
environments, regardless of intervening 
paragraph breaks. 

Displays typeout examples in an unfilled 
environment using fixed-width tyipeface. It 
widens the right margin. 

Displays enclosed text in bold italics. 

Displays enclosed text in a filled environment 
using Roman (default) typeface. It widens both 
margins. 

Displays enclosed text in Roman typeface. For 
example to override the default typeface of the 
italicize environment: @I(The Iliad @r[and] 
The Odyssey) produces The Iliad and The 
Odyssey. 

Displays each line in boldface type in an 
unfilled environment flush to the left margin. 

Displays tables in an unfilled environment using 
Roman (default) t3rpeface with no changes to 
the margins. 

Displays enclosed text in a filled environment. 

Displays enclosed text in an unfilled 
environment in fixed-width typeface with no 
changes to the margins. 

Displays enclosed text in fixed-width typeface. 



How to Use 
Formatting Commands 

Formatting commands control the format of the text (such as 
blank spaces between lines, tab settings, line breaks) and whether 
the formatter centers the text or aligns it against one of the 
margins. 
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For example: 

@i (Gone With the Wind),@* by Margaret Mitchell @# is a @b(great) book, 

produces: 

Gone With the Wind, 

by Margaret Mitchell is a great book. 

The (3)* command forces a line break and the (§)# command leaves 
a blank em-space for a special character to be drawn in. 

Some commands, like the @* in the example, are complete by 
themselves. Others accept arguments, which must be enclosed in 
delimiters. There is no such thing as a long form for a 
command; you cannot say @begin(blankspace) for example. 



Basic Text 
Formatting Commands 



(5)blankspace 



@caption 



@foot 

@note 
@tabclear 



On paper, leaves the specified amount of blank 

space on the page (for example, 

@blankspace(lline)). Distance can be specified 

with: 

in, inch, inches, " 

cm, centimeters 

mm, millimeters 

pt, pts, point, points 

pica, picas 

em, ems, quad, quads 

char, chars, character, characters, en, ens 

line, lines 

On the screen, display truncates the blank 
space to roughly one inch of vertical space. 

Creates a figure caption enclosed in square 
brackets, for example, use @capt ion [This is the 
caption] to produce: [Figure Caption: This is 
the caption.] 

Puts in a parenthetical note. Does not create 
bottom-of-the-page footnotes or numbering. 

Puts in a parenthetical note. 

Clears all tabs. It takes no arguments: use 
@tabclear(). 
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@tabdivide Sets tabs to divide text into the specified 

number of columns, for example, 
8tabdivide(4) sets tabs to divide the following 
text into 4 columns across the page. 

@tabset Sets one or more tabs at specified positions. 

Distance can be specified with: 
in, inch, inches, " 
cm, centimeters 
mm, millimeters 
pt, pts, point, points 
pica, picas 

em, ems, quad, quads 
char, chars, character, characters, en, ens 
line, lines 

These pimctuation-character commands consist of an @ followed 
by one punctuation character. They take no arguments. 

@# Leaves a blank space (quad space or em-space) 

for a special character. 

@* Forces a line break. 

@. Generates a period and forces a single 

significant space after it (used for 
abbreviations). 

@= Sets a tab at the left side of text to be 

centered. Do not use in a filled environment. 
Works with the tab commands «2)\, @>, or @=). 

@> Sets a tab at the left side of text to be flushed 

right. Do not use in a filled environment. 
Works with the tab command (@\, @>, or @=). 

@\ Moves the cursor to the next tab stop or marks 

the end of text being centered or flushed right. 
Do not use in a filled environment. 

@* Sets a tab at the current cursor position. Do 

not use in a filled environment. 

@@ Inserts an @ in the text. 

@' Ignores all the white space between it and the 

next text in the source. 
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Example of Using 
Tabs to Format Text 

This example shows how to use tab stops to: 

• Divide text into four columns 

• Center text 

• Flush right text 

• Reset tabs 

@begin (format) 

@tabclivide(4) 

1 .@\*@\*ia\* 

2.@=aia\@=b(a\@=c@\@=d 

3.@=e@=f@=g@=h 

4 . Lef t@=Center@>ri ght 

5 . Lef t@=Center@>ri ght@\ 

@tabclear() 

6 . Lef t@=Center@>ri ght 

@end( format) 

produces: 



1. 


* 




* 




* 






2. a 




b 




c 




d 




3. e 




f 




g 




h 




4.LefCenter 














right 


5.LefCenter 






right 










e.Left 






Center 








right 



Zmacs Format Commands 

The second (and final) step in formatting is to issue one of the 
formatting commands, which interprets the text and formatting 
instructions into the formatted text. 

You can use the commands to format the text on your screen or 
on a printer. Check first on the screen before sending output to 
a printer. 

Use a numeric argument to send the output to an LGPl, LGP2, 
or DMPl. Page numbers are included by default on hardcopy 
output. You can turn off page-numbering with a numeric 
argument of 0. 
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Format Region 



Format Buffer 



Format File 



Format Region (n-X) 

Displays the contents of the region formatted as a text 
environment. With a numeric argument, the command prompts 
for an output device. Page numbers are included by default on 
hardcopy output. You can turn off page-numbering with a 
numeric argument of 0. 



Format Buffer (n-X) 

Displays the contents of the buffer, formatted as a text 
environment. With a numeric argument, the command prompts 
for an output device. Page numbers are included by default on 
hardcopy output. You can turn off page-numbering with a 
numeric argument of 0. 



Format File (n-X) 

Displays the contents of the file, formatted as a text environment. 
With a numeric argument, the command prompts for an output 
device. Page numbers are included by default on hardcopy 
output. You can turn off page-numbering with a numeric 
argument of 0. 
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Executing CP Commands From Zmacs 



If you wish to execute a CP command while editing, you can press 
SUSPEND and issue the command in the typeout window, you can 
press SELECT -L and issue the command to a Lisp Listener, or you 
can issue the n-X Execute CP Command command. 

Execute CP Command 

n-X Execute Cp Command 

Reads a CP command line from the minibuffer and executes that 
command. All output from the command appears in the Zmacs 
typeout window. 
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Overview of 
Leaving Zmacs 

Use a system- wide command to switch programs, such as SELECT, 
FUNCTION S, the System menu, or, if you have multiple windows 
on the screen, position the mouse to another window and click. 

Leaving Zmacs 
with the SELECT Key 

A set of windows is always available by pressing the SELECT key 

and then one of the following keys: 

Key Program 

C Converse, for messages to other users 

D Document Examiner, for examining documentation 

E Editor, the Zmacs text and program editor 

F File system editor for access to files and directories 

I Inspector, for inspecting and modifying data 

structures 
L Lisp 

M Mail reading and sending system 

N Notifications, for rereading system notifications 

P Peek, a system status display 

T Telnet, a virtual terminal utility for logging in to 

other hosts 
H Flavor Examiner, for examining the structure of 

flavors that are defined in the Lisp environment 



Leaving Zmacs Via 
the System Menu 

The System menu is a momentary menu that lists several choices 
for acting upon windows and calling programs (for example, a 
Lisp Listener, Zmacs, or the Inspector). You can always call the 
System menu by clicking [(R2)] (the right mouse button twice or 
holding down the SHIFT key and clicking right once ). Use the 
System menu to do many things, among them: 

• Create new windows. 

• Select old windows. 

• Change the size and placement of windows on the screen. 

• Hardcopy a file. 
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Leaving Zmacs 

with c-Z 

The Zmacs command c-Z returns you to the window in which the 
ed function was most recently called, usually the Lisp Listener. 
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Getting Out of Trouble 



Overview of 

Getting Out of Trouble 

Sometimes you type the wrong command. Mostly it is obvious 
what you have done wrong, and it is a simple matter to undo it. 
There are, however, some kinds of trouble you can get into that 
require special remedies. For example, you might accidentally 
delete large chunks of text you need or you might begin to type a 
command and then change your mind. 

This section tells you how to recover from these situations. 

Getting Out of 
Prefixes and Prompts 

Most of the commands we have described are single keystrokes, 
but some keystrokes are prefixes that must be completed with a 
second keystroke to specify a command. c-X is the most 
important of these. 

Getting Out of 

Keystroke Prefixes 

If you press a c-X and don't mean it, you can get out by pressing 
either c-G or ABORT. These are general "get me out of here" 
commands, which you should use whenever you get yourself into a 
confused state. RBORT and c-G are, for the most part, S3nion3mious 
in Zmacs. 

Getting Out of 

Minibuffer Prompts 

Sometimes you accidentally type a command that prompts for 
some additional information, or you type such a command on 
purpose and change your mind afterwards. When Zmacs prompts 
and you just want to get out of the minibuffer and back to where 
you were, press RBGRT. If, instead, you wish to cancel arid reenter 
your response, use c-G, which clears any typein but leaves you 
still in the minibuffer. When the minibuffer is empty, c-G 
cancels the minibuffer command. (With some echo area prompts, 
you have to use RBORT.) 

RBORT Abort At Top Level 

Cancels the last command typed. It also cancels numeric 
arguments and region marking. 
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c-G Beep 

Cancels the last command. It also cancels numeric arguments 
and region marking, except when given an argument. It cancels 
one thing at a time, so that if you've typed a number of 
commands or responses, you must use use successive c-Gs to 
cancel each one and return to top level. 

Large Deletions 

Do not delete large pieces of text by repeatedly pressing RUBGUT 
and c-D. Apart from being slow, text deleted character-by- 
character is gone for good. 

Instead, use delete and kill commands that save deleted regions in 
the kill history. c-K, n-K, and the commands that deal with 
regions easily wipe out and save larger chunks. Also, RUBGUT or 
c-D with a numeric argument erases that many characters all at 
once and saves them in the kill history. For full descriptions of 
these delete and kill commands: See the section "Deleting and 
Transposing Text in Zmacs", page 83. 

Getting Text Back 

The system has different histories for different contexts. One of 
these is always the current history. The two histories that you 
need to use for yanking in Zmacs are the kill history and the 
command history. The kill history remembers pieces of text that 
you killed or copied into it. In the context of Zmacs, the 
command history remembers all the editor commands that use the 
minibuffer in any way. 

Additions to the histories are placed at the top of the list, so that 
history elements are stored in reverse chronological order - the 
newer elements at the top of the history, the older elements 
toward the bottom. A history remembers ever3^hing that has 
been tyiped to it since the last cold boot - it has no size limit. 

Yanking commands pull in the elements of the history. Top-level 
commands start a yanking sequence; for example, c-Y yanks back 
the last text killed from the kill history, and c-n-Y yanks back 
the last command performed in the minibuffer. n-Y performs all 
subsequent yanks in the same sequence; for example, pressing n-Y 
while the kill history is the current history yanks the next item 
from that history. 

A yanking sequence ends when you type new text, execute a form 
or command, or start another yanking sequence. 

For complete descriptions of killing and yanking: See the section 
"Working with Regions in Zmacs", page 99. 
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Finding Out About Zmacs Commands 



Overview of 
Finding Out About 
Zmacs Commands 

Sometimes you want to know if a Zmacs command exists that 
performs a certain function. Or, you might think that you know 
what a certain keystroke does, but you still want to make sure, or 
refresh your memory about its exact usage. This manual is one 
resource you might use in these circumstances. Zmacs itself has 
a number of built-in self-documentation facilities. This section 
describes some ways to get at this documentation. 

Finding Out About 

Zmacs Commands 

with HELP 

The HELP key is a prefix to a useful group of commands giving 
various kinds of online help. If you forget what a command does, 
which keystrokes perform an action, or have no idea how to 
accomplish something, press HELP. 

Whenever you have a question of any kind, press HELP. Zmacs 
prompts you in the minibuffer for details on what kind of help. If 
you don't know, press HELP again and it tells you, in the typeout 
window, how to find what you're looking for. The typeout window 
displays right over the editor window. The actual contents of the 
buffer are not affected, and the next command you type restores 
the buffer display. 

Finding Out What 

a Zmacs Command Does 

HELP C 

The command HELP C displays "Document Command:" below the 
mode line and waits for you to type a command. When you do, 
Zmacs displays the internal documentation for that command. 



Example 



If you press HELP-C followed by c-F, the response is: 

c-F is Forward, implemented by COM-FORWARD: 

Moves forward one character. 

With a numeric argument (n) , it moves forward n characters. 

The first line above tells you the name of the command (in this 
case Forward), and the name of the internal Lisp function that 
actually does the work (in this case zl-user:com-forward). (You 
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don't need to know these internal names for basic editing.) The 
COM-xxx name displayed by HELP C is mouse-sensitive: clicking 
left on it edits the COM-xxx function, and clicking right displays a 
menu with choices of ArgKst, Edit, Disassemble, and 
Documentation. 

The next line is a very short description of what the command 
does; it usually tells you what the command does without a 
numeric argument and how a numeric argument modifies that 
behavior. 

Finding Out What a 

Prefix Command Does 

When you ask (with HELP C) for documentation on a prefix 
command like c-X, Zmacs prompts you, in the t3npeout window, to 
complete the command. Zmacs displays the documentation for the 
prefix command in the typeout window. 



Finding Out What 
an Extended 
Command Does 



HELP D 

When you want to find out what an extended command does, you 
can display the documentation for the command by pressing HELP 
D, which prompts in the minibuffer "Describe command:", to 
which you type the command's name. 



Searching for 

Appropriate Zmacs Commands 

HELP R 



n-X Apropos 

When you can only guess at part of the name or function of a 
command by the action it performs, there is a command, HELP R, 
to help you scan information about all the available Zmacs 
commands to find the one you want. All you have to do is type in 
a string, such as "buffer" and all command names plus the first 
line of all help documentation are scanned for the string you 
specify. 

Each Zmacs command has a name. The name is almost always 
exactly what you would expect; that is, the name describes the 
function of the command in reasonably plain English. If not, the 
word you're looking for is almost surely in the first line of the 
help documentation. 
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With a numeric argument, HELP fl searches only the command 
names. 

The A stands for apropos. The n-X Apropos command works the 
same way. 

Method for 

Searching for 

Appropriate Zmacs Commands 

To find the command you want, just press HELP fl or type n-X 
Apropos. Zmacs prompts you for a substring, you enter your 
guess, and then Zmacs displays short descriptions of all the 
commands whose names contain that substring. If the substring 
that you enter contains a space, then Zmacs displays a short 
description of all the commands whose names or help 
documentation includes a similarly positioned space. Each 
description gives the short documentation for the command and 
tells what keystrokes invoke it. 

Example of a Search 

String for HELP R 

The command you perform when you use n-Q is called "Fill 
Paragraph", so you might expect a command that counts the 
number of paragraphs in the buffer to be called something like 
"Coimt Paragraphs" or "Paragraphs Count". No matter what, the 
word paragraph is going to be in the name or the first line of the 
help documentation. 

Finding Out What 
You Have Typed 

HELP L 

As you are editing you might find yourself in a hopelessly 
confused state and not know how to recover. 

If this happens to you it is often very enlightening to press HELP 
L to list the last 60 keystrokes you typed. By examining your own 
recent activity, it is often possible to find out where you went 
wrong and how to save yourself. 

More HELP 
Commands for 
Finding Out About 
Zmacs Commands 
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HELP U 

Offers to undo the last "major" operation (such as fill or sort). 

HELP y 

Displays all the Zmacs variables whose names contain a certain 
substring. For descriptions of Zmacs variables: See the section 
"How to Specify Zmacs Variable Settings", page 269. 

HELP U 

Finds out whether an extended command is bound to a key. 

General 

Information-giving 
Zmacs Commands 

The following commands display: 

• Information about the location of point 

• Documentation about a specified Lisp function 

• Argument list for the specified Lisp function 

• Information about the current Lisp variable 

• The number of lines in the region or page 

• Possible parenthesis mismatches 

• Trace information about the specified Lisp function 

The word currenty when describing a Lisp function or a Lisp 
variable, refers to (approximately) the function or variable whose 
name is nearest to the cursor. 

c-X = Where Am I 

Displays various things about the location of point. It displays 
the X and Y positions, the octal code for the following character, 
the current line number and its percentage of the total file size. 
If there is a region, it displays the number of lines in it. Fast 
Where Am I (c-=) displays a subset of this information more 
quickly. 

c-= Fast Where Am I 

Quickly displays various things about where point is. It displays 
the X and Y positions and the octal code for the following 
character. If there is a region, it displays the number of lines in 
it. Where Am I displays the same things and more. 
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n-sh-D Show Documentation 

Displays the documentation for the given topic. It prompts for a 
topic name offering completion only on topics in the 
documentation database. With a numeric argument, n-sh-D 
directs the display to either the screen or paper (hardcopy). 

See the section "The Document Examiner" in User's Guide to 
Symbolics Computers. 

c-sh-D Long Documentation 

Displays the documentation string for the specified function. It 
prompts for a function name, which you can either type in or 
select with the mouse. The default is the current function. 

When this command does not find a documentation string, it 
suggests you use Show Documentation (n-X) or the Document 
Examiner to see the function's online documentation. 

c-sh-fl Quick Arglist 

Displays the argument list for the current function. With a 
numeric argument, it reads the function name from the 
minibuffer. 

Arglist (n-H) 

Displays the argument list of the specified function. It reads the 
name of the function (from the minibuffer) and displays the 
argument list in the echo area. 

c-sh-U Describe Variable At Point 

Displays information in the echo area about the current Lisp 
variable. The information displayed shows whether it is declared 
special, whether it has a value, and whether it has documentation 
put on by defvar. When nothing is available, it checks for 
lookalike symbols in other packages. 

n-= Count Lines Region 

Displays the number of lines in the region. 

c-X L Count Lines Page 

Displays the number of lines on the current page (or the buffer, 
if there are no page delimiters). In parentheses, it displays the 
number of lines up to the line containing point and the number of 
lines after the line containing point. 
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Find Unbalanced Parentheses (n-X) 

Finds any parenthesis mismatch error in the buffer. It reads 
through all of the current buffer and tries to find places in which 
the parentheses do not balance. It positions point to possible 
trouble spots, printing out a message that says what the trouble 
appears to be. This command finds only one such error; if you 
suspect more errors, run it again. 

Trace (n-H) 

Traces or untraces a function. It reads the name of the function 
from the minibuffer and then it pops up a menu of trace options. 
With an argument, it omits the menu step. 

See the special form trace in Program Development Utilities. 

See the section "Options to trace" in Program Development 
Utilities. 
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Overview of the 
Editor Menu 



Click right in Zmacs to display the editor menu, a momentary 
menu containing editor commands, each of which is a possible 
choice. Position the mouse cursor over an item and then click 
the appropriate button to make the choice. 



For complete descriptions of the editor menu commands: 
section "Editor Menu Commands", page 57. 



See the 



Editor Menu Commands 

The Editor Menu commands are: 



Command 
Arglist 



Edit Definition 



List Callers 



List Definitions 



List Buffers 



Kill Or Save Buffers 



Description 

Prints the argument list of the 
specified function: See the section 
"General Information-giving Zmacs 
Commands", page 54. 

Prepares to edit the definition of a 
specified function: See the section 
"Editing Lisp Programs in Zmacs", 
page 223. 

Lists all functions that call the 
specified function: See the section 
"Editing Lisp Programs in Zmacs", 
page 223. 

Displays the definitions in a specified 
buffer: See the section "Editing Lisp 
Programs in Zmacs", page 223. 

Prints a list of all the buffers and 
their associated files: See the section 
"Manipulating Buffers and Files in 
Zmacs", page 129. 

Offers a menu of modified files with 
choices to kill, save, or remove the 
modification flag from the file: See 
the section "Manipulating Buffers 
and Files in Zmacs", page 129. 
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Split Screen 



Compile Region 



Indent Region 



Change Default Font 



Change Font Region 



Uppercase Region 



Lowercase Region 



Indent Rigidly 



Indent Under 



Makes several windows split among 
the buffers as specified: See the 
section "Manipulating Buffers and 
Files in Zmacs", page 129. 

Compiles the region, or if no region 
is defined, the current definition: See 
the section "Editing Lisp Programs in 
Zmacs", page 223. 

Indents each line in the region: See 
the section "Changing Case and 
Indentation in Zmacs", page 213. 

Sets the default font: See the section 
"Working with Regions in Zmacs", 
page 99. 

Changes the font for the region: See 
the section "Working with Regions in 
Zmacs", page 99. 

Changes any lowercase characters in 
the region to uppercase: See the 
section "Working with Regions in 
Zmacs", page 99. 

Changes any uppercase characters in 
the region to lowercase: See the 
section "Working with Regions in 
Zmacs", page 99. 

Shifts text in the region sideways as 
a unit: See the section "Changing 
Case and Indentation in Zmacs", page 
213. 

Fixes indentation to align under 
either a character that you click on 
with the mouse cursor or a string 
read from the minibuffer: See the 
section "Aligning Indentation in 
Zmacs", page 220. 
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Minibuffer 
Response Format 

Most commands expect only one line of response. In these cases, 
the END key has the same meaning as the RETURN key, terminating 
the response. 

However, for commands that expect one or more lines of response, 
RETURN has its usual significance, inserting a newline in the 
minibuffer, and END marks the end of the response. 

Minibuffer 
Response Help 

While responding to a prompt, you can press HELP to get 
documentation describing the current situation. Zmacs tells you 
exactly what input it expects and what the possible responses are. 

More Ways to 

Enter Minibuffer Responses 

Yanking and mousing provide quick and simple ways to enter 
minibuffer responses without having to type them out. Both of 
these methods are context-sensitive. Yanking works only when 
you have previously entered a minibuffer response. Mousing 
works when you click on a name that makes sense in the context 
of the minibuffer prompt. 

Yanking in the Minibuffer 

c-n-Y Repeat Last Minibuffer Command 

Repeats a recent minibuffer command. It yanks the displayed 
default if there is one, otherwise, it yanks the last thing typed in 
this context. A numeric argument n yanks the nth previous one. 
An argument of lists the history of elements t3T)ed in the 
minibuffer. 

For a similar command with string-matching: See the section 
"Retrieving History Elements", page 87. 

After c-n-Y, m-Y replaces what was yanked with a previous 
element of the same history, in this case, another minibuffer 
command. For more details: See the section "Retrieving History 
Elements", page 87. 

n-Y Yank Pop 

Corrects a yank to use a different element of its history. The 
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most recent command must be a yanking command (c-Y, n-Y, 
c-sh-Y, n-sh-Y or c-n-Y). The retrieved item (text or command) 
that was yanked by that command is replaced by the previous 
element of the corresponding history. The history is rotated (that 
is, the elements remain in the same order, but the pointer to the 
current element moves with each successive n-Y) to bring this 
element to the top. 

A numeric argument of zero displays the history. A positive 
numeric argument of n moves n elements back in the history. A 
negative numeric argument moves to a newer history element; 
this only makes sense after you rotate the history. 
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Getting Information About Buffers and Regions 



A good deal of information is available about each Zmacs buffer 
or region. You can get a count of characters, words, lines, 
paragraphs, or pages, as well as a count of substrings or Lisp 
objects. 



Count Chars 



r\-X Count Chars 

Counts the characters in the region or in the buffer if there is no 
region. 



Count Words 



n-X Count Words 

Counts the words in the region or in the buffer if there is no 
region. 



Count Lines 



n-X Count Lines 

Counts the lines in the region or in the buffer if there is no 
region. 



Count Paragraphs 



n-X Count Paragraphs 

Counts the paragraphs in the region or in the buffer if there is 
no region. 



Count Pages 



n-X Count Pages 

Counts the pages in the region, or in the buffer if there is no 
region. 
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Count Occurrences 

n-X Count Occurrences 

Counts how many times a certain substring occurs in the region 
or in the buffer following point if there is no region. 

See the section "How Many", page 62, 



How E\/Iany 



n-X How Many 

Counts how many times a certain substring occurs in the buffer 
following point. You are prompted for the substring. 

See the section "Count Occurrences", page 62, 
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Overview of Moving the Cursor 



Summary of 
Cursor Movement 

To make changes at a particular place in a Zmacs buffer, you 
must move the cursor to that place, since most commands that 
modify the buffer do so immediately around the cursor. 

The cursor movement or motion commands: 

• View the contents of the buffer 

• Redisplay the editor window 

• Move the cursor around the buffer using mouse commands 

• Move the cursor around the buffer using keystroke commands 

The Editor 

Window and the Buffer 

The editor window displays either a portion of your buffer or the 
whole buffer, depending on the size of the buffer and your current 
location in it. 

When the current buffer is smaller than the exact size of the 
editor window, Zmacs displays the contents of the buffer at the 
top of the window and leaves the bottom of the window blank. 
You cannot tell whether the buffer actually comes to an end 
where the text stops, since there could be white space and 
newline characters after the last visible piece of text. 

When the buffer is too large to fit on the screen, the editor 
window shows only a section of the buffer. The part that shows 
always contains the cursor, so it never vanishes off the top or 
bottom of the editor window. Zmacs changes the position of the 
editor window inside the buffer as seldom as possible - usually 
only when you try to move the cursor off the top or bottom of the 
screen. 

Wraparound Lines 

in the Editor Window 

Lines that are too long to fit across the editor window are 
displayed on as many physical lines as are necessary. An 
exclamation point (!) in the (normally blank) last column means 
that the next physical line is part of the same logical line. 
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Introduction to 
Redisplaying the Window 

Whenever you modify the buffer's contents or move point or the 
mark, Zmacs updates the display to reflect the change. (For a 
discussion of the mark: See the section "Working with Regions in 
Zmacs", page 99.) This updating can be as simple as moving the 
cursor or as involved as figuring out the whole display from 
scratch. These operations are called redisplay and Zmacs 
performs them automatically. 

For example, when you move the cursor off the top or bottom of 
the editor window, a complete redisplay is required. The window 
has to shift to show a different part of the buffer in order to keep 
the cursor visible. 

You can explicitly tell Zmacs to do a redisplay with the Recenter 
Window command, invoked by c-L. You might want to do this if 
the cursor gets too close to the top or the bottom of the editor 
window, and you want to redisplay with the cursor closer to the 
center so that you can see more context in one direction or the 
other. 

It is important to remember that redisplay operations change only 
the display, not the actual contents of the buffer. 

Recentering the Window 

c-L Recenter Window 

Completely redisplays the screen, leaving the cursor near the 
middle of the editor window. 

With a numeric argument of /i, it leaves the cursor n lines from 
the top of the window. With a negative numeric argument of -/i, 
it leaves the cursor n lines from the bottom of the window. 



Displaying the 
Next Screen 



c-V, SCROLL Next Screen 

Moves the cursor to the beginning of the last visible line in the 
editor window and redisplays the screen with that line at the top 
of the window. 

With a numeric argument of n, it moves the text up n lines. 
With a negative numeric argument -n, it moves the text down n 
lines. The cursor does not move (with respect to the text) unless 
the numeric argument is large enough to slide it off the screen. 
In that case the cursor remains at the top. 
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Displaying the 
.Previous Screen 

n-U, n-SCROLL Previous Screen 

Moves the cursor to the beginning of the first visible line in the 
editor window and redisplays the screen with that line at the 
bottom of the window. 

With a numeric argument of n, it moves the text down n lines. 
With a negative numeric argument -n, it moves the text up n 
lines. The cursor does not move (with respect to the text) unless 
the numeric argument is large enough to slide it off the screen. 
In that case the cursor remains at the bottom. 

Positioning the 

Window Aroiuid a Definition 

c-n-R Reposition Window 

Redisplays, trying to get all of the current function definition in 
the window. It puts the beginning of the current definition at the 
top of the window with the current position of the cursor still 
visible. Doing c-n-R twice pushes comments off the top of the 
window, making more of the code of a large function visible. 



Moving to a 
Specified Line 



n-R Move To Screen Edge 

Moves to the beginning of a specified line on the screen. With no 
argument, it moves to the beginning of a line near the middle of 
the screen. The exact line is controlled by the Zmacs variable 
Center Fraction. A numeric argument specifies a particular line 
to move to. Negative arguments count up from the bottom of the 
window. (For descriptions of Zmacs variables: See the section 
"How to Specify Zmacs Variable Settings", page 269.) 
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Introduction to 
Using the Mouse 

The easiest way to get the cursor where you want it is with the 
mouse. See the section "The Mouse" in User's Guide to Symbolics 
Computers. 

Mouse 

Documentation 
Line in Zmacs 

The mouse documentation hne at the bottom of the screen tells 
you what will happen when you click the mouse. The small arrow 
cursor tells you where the mouse is and what it is over. What 
you can do with the mouse depends on what the mouse is over. 

There are five sets of possible mouse actions, corresponding to 
four things the mouse can be over in a Zmacs buffer: 

Text or blank space 

Scroll bar 

Upper left corner of screen 

Upper right corner of screen 

The mouse documentation line is two lines high. The top line 
tells you what you can do with the three mouse keys. The bottom 
line tells you what keyboard keys you can press to change the 
action of the mouse keys. When you press one of these keyboard 
keys, the top mouse documentation line tells you what you can do 
with the three mouse keys while that keyboard key is held down. 

The three mouse keys are called L for left, M for middle and R 
for right. 

The keyboard keys are called c for CONTROL, Sh for SHIFT, s for 
SUPER and m-sh for tlETfl-SHIFT. 

COMTROL and SHIFT affect editing operations. Their actions are 
described in this section. 

METfl-SHIFT with the right mouse button gives you access to the 
window operation menu, which allows you to move, reshape, 
expand, bury, kill, or hardcopy the window or pane. 

SUPER with the right mouse button gives you access to the 
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presentation debugging menu. 



Mouse Over Teict 
or Blank Space 

Here is a description of what you can do with the mouse when it 
is over text or blank space in a Zmacs buffer. 



Notation 
LiMove point 



sh-L:Move to point 



M:Mark thing 



Description 

Performs two separate actions, depending on 
whether you click left or hold left down. 

• Relocates the cursor: position the mouse 
cursor to the desired location and click 
left. If the cursor is over blank space, 
point is moved to the end of the line. 

• Marks a region: position mouse cursor to 
desired location, hold left button down, 
move mouse cursor to end point of desired 
region and release the button . 

Relocates the mouse arrow cursor to point 
(where the blinking cursor appears). 

Marks (makes into a region) the object on 
which you click Clicking after the end of a 
line or before the first nonblank character of 
a line marks the whole line. Clicking on a 
word marks that word. 

In Lisp mode, however, if that word is part 
of what could be a symbol's printname, it 
marks that whole symbol name. Clicking on 
an open or close parenthesis marks all the 
text between that parenthesis and its 
matching parenthesis, including the 
parentheses. Clicking on an open or close 
quotation mark (") marks the whole quoted 
string. Clicking between words marks all 
text up to the end of the next word or 
possible sjnnbol printname, depending on 
mode. For a complete description of 
marking regions: See the section "Working 
with Regions in Zmacs", page 99. 
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c-M:Copy Mouse Inserts the object on which you click, as 

though you had t3^ed it. This allows you to 
build a program or document by selecting 
things already appearing on your screen, in 
the manner of a menu. Hold down the 
control key and click middle on the object 
you want to copy: it is inserted as though 
you had just t3T)ed it. If you change your 
mind, and want to remove what you have 
just inserted, type c-W, and it is removed. 

The object copied can be a word, a printed 
representation of a Lisp sjonbol, a 
parenthesized or quoted group of words, a 
printed representation of a lisp list or string, 
or a line. What object is picked up by 
clicking c-(l1) on it is determined by the 
same rules as Mark Thing (M) in Lisp 
Mode. That is: 

• Clicking after the end of a line or before 
the first nonblank character of a line 
copies the whole line. Clicking on a word 
picks up that whole word, or possible Lisp 
Symbol printname of which that word 
could be part. 

• Clicking on an open or close parenthesis 
copies the text between that parenthesis 
and its matching parenthesis, including 
the parentheses. Clicking on an open or 
close quotation mark (") copies the whole 
quoted string. Clicking between words 
copies all text up to the end of the next 
word (or possible symbol printname). 

Appropriate spaces are placed before the 
inserted object. 

sh-M:Save/Kill/Yank Performs one of four related actions: 

• If there is a region, it saves the region in 
the kill history while leaving it in the 
buffer (like n-W) 

• If the last command saved the region, it 
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R: Editor menu 



wipes it from the buffer (like c-W except 
it does not save) 

• If the above two conditions do not apply, 
it yanks the first element from the kill 
history (like c-Y) 

• If the last command was a yank command, 
it yanks the next item from the kill 
history (like n-Y) 

For a complete description of saving, killing, 
and yanking regions: See the section 
"Working with Regions in Zmacs", page 99. 

Displays a Zmacs menu offering mouse- 
sensitive Zmacs commands. 



sh-R:System Menu Displays a System menu. 



Mouse Over Scroll Bar 

The scroll bar consists of a pair of dotted lines with a shaded 
section between them. The shaded section, or elevator, represents 
the portion of the buffer visible on the screen and the dotted 
lines, or shaft, represent the entire buffer. In general, you see 
only the shaft, but not the elevator. Move the mouse cursor over 
the shaft and the elevator appears. The elevator remains visible 
until the buffer changes in size, whereupon it disappears until 
you move the mouse cursor over the shaft again. 
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Introduction to the 
Motion Commands 

Zmacs word, sentence, and paragraph motion commands all have 
strict definitions for where words, sentences, and paragraphs 
begin and end. You can modify all these definitions. 

Numeric 

Arguments and 

the Motion Commands 

All of the motion commands allow numeric arguments. For the 
most part, these numeric arguments are interpreted as repeat 
counts. 

Example of Numeric 
Arguments with 
Motion Commands 

n-F moves the cursor forward one word, whereas n-13F moves the 

cursor forward 13 words. 

Negative Numeric 

Arguments and 

Motion Commands 

Most of the motion commands come in pairs, with one command 
for forward motion over a particular unit and one command for 
backward motion. Both kinds of commands often interpret 
negative numeric arguments by reversing the direction of motion. 

These conventions - that Zmacs interprets numeric arguments as 
repeat counts, and that negative numeric arguments reverse the 
direction of motion - together make up the motion convention. 

Example of Negative 
Numeric Arguments 
with Motion Commands 

n- -13F moves point backward 13 words. n-13B has exactly the 

same effect. 

Motion by Character 

A Zmacs character can be any letter, number, or punctuation 
character. 
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Forward Character 

c-F Forward 

Moves the cursor forward over one character. c-F interprets 
numeric arguments as repeat counts. 

Negative numeric arguments reverse the direction of motion. For 
example, c-3B and c- -3F both move the cursor backwards three 
characters. 

Backward Character 

c-B Backward 

Moves the cursor backward over one character. c-B interprets 
numeric arguments as repeat counts. 

Negative numeric arguments reverse the direction of motion. For 
example, c-3 c-B and c — c-3 c-F both move the cursor 
backwards three characters. 

Motion by Word 

Zmacs generally considers a word to consist of a sequential string 
of alphanumeric characters, that is, any combination of the 
characters a-z, A-Z, and 0-9. Different major modes define their 
own delimiter characters. For example, in Text Mode an 
apostrophe (') is part of a word, but in other modes it is a 
delimiter. (For mode descriptions: See the section "Setting the 
Zmacs Major Mode", page 175.) 



Forward Word 



n-F Forward Word 

Moves the cursor forward one word. Numeric arguments are 
interpreted as repeat counts; negative numeric arguments reverse 
the direction of motion. 

n-F always places the cursor at the end of a word. If the cursor 
is in the middle of a word, n-F moves the cursor to the end of 
that word. 



Backward Word 



n-B Backward Word 

Moves the cursor backward one word. Numeric arguments are 
interpreted as repeat counts; negative numeric arguments reverse 
the direction of motion. 
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n-B always places the cursor at the beginning of a word. If the 
cursor is in the middle of a word, n-B moves the cursor to the 
beginning of that word. 

Motion by Sentence 

Description of Zmacs Sentence Deiimiters 

According to Zmacs, sentences can end with question marks, 
periods, and exclamation points. Furthermore, these punctuation 
marks only end a sentence when followed by: 

• A newline 

• A space followed by either a newline or another space. 

However, Zmacs allows any number of closing characters, which 
are ", ', ), and ], between the sentence-ending punctuation and the 
white space that follows it. A sentence also starts after a blank 
line. 

This corresponds closely to standard typing conventions. Zmacs 
does not recognize a period followed by one space as the end of a 
sentence, for example, as in "e.g. " or "Dr. ". 

Forward Sentence 

n-E Forward Sentence 

Moves the cursor forward one sentence. 

Numeric arguments are interpreted as repeat counts; negative 
numeric arguments reverse the direction of motion. 

n-E always places the cursor at the end of a sentence. If the 
cursor is in the middle of a sentence, n-E moves the cursor to the 
end of that sentence. 

Backward Sentence 

n-fl Backward Sentence 

Moves the cursor backward one sentence. 

Numeric arguments are interpreted as repeat counts; negative 
numeric arguments reverse the direction of motion. 

n-R always places the cursor at the beginning of a sentence. If 
the cursor is in the middle of a sentence, n-fl moves the cursor to 
the beginning of that sentence. 
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Motion by Line 

Lines are delimited by special characters called newlines. 



Down Line 



c-N Down Real Line 

Moves the cursor straight down to the corresponding column of 
the next line. If the cursor is positioned in the middle of the 
line, c-N moves it to the middle of the next one. 

With a numeric argument n, it moves the cursor down n lines. 
Moving down a negative number of lines is the same as moving 
up. 

Up Line 

c-P Up Real Line 

Moves the cursor straight up to the corresponding column of the 
previous line. If the cursor is positioned in the middle of the 
line, c-P moves it to the middle of the previous one. 

With a numeric argument of ti, it moves the cursor up n lines. 
Moving up a negative number of lines is the same as moving 
down. 

Beginning of Line 

c-fl Beginning of Line 

Moves the cursor to the beginning of the current line. 

With a numeric argument of n, it moves the cursor to the 
beginning of the nth. line after the current one, where the current 
line is numbered 1, the preceding line is numbered 0, and so on. 



End of Line 



c-E End Of Line 

Moves the cursor to the end of the current line. 

With a numeric argument of n, it moves the cursor to the end of 
the nth line after the current one, where the current line is 
numbered 1, the preceding line is numbered 0, and so on. 



Goal Column and 
the Motion Commands 
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Set Goal Column 

c-H c-N Set Goal Column 

Sets the default column position (goal column). The goal column 
sets point position for c-N and c-P. It disables the default action 
of matching the goal column to point's current column and sets 
the goal column to zero instead. With a numeric argument n., 
sets the goal column to n. c-U turns it off (sets it back to the 
default state of keeping cursor in same horizontal position for c-N 
and c-P). 
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Description 

Motion by Lisp expression repositions the cursor according to Lisp 
code delimiters: lists and expressions. A list is something 
enclosed in balanced parentheses. A Lisp expression is any 
readable printed representation of a Lisp object. 

c-n-N Forward List 

Moves forward over one list. It accepts a numeric argument for 
repetition count. 

c-n-P Backward List 

Moves backward over one list. It accepts a numeric argument for 
repetition count. 

Motion Along One 
Nesting Level 

Point always sits either between two expressions or in the middle 
of a Lisp object (excluding a list or nil). 

c-n-F Forward Sexp 

Moves point to the end of a surrounding Lisp object (excluding a 
list or nil) if there is one, or past the Lisp expression 
immediately to the right if not. 

If parentheses are unbalanced to such an extent that it doesn't 
make sense to talk about "the expression on the right", this 
command gives an error message and does not move point at all. 

c-n-F observes the motion convention for numeric arguments. 

c-n-B Backward Sexp 

Moves point to the beginning of a surrounding Lisp object 
(excluding a list or nil) if there is one, or to the beginning of the 
Lisp expression immediately to the left if not. 

If parentheses are unbalanced to such an extent that it doesn't 
make sense to talk about "the expression on the left", this 
command gives an error message and does not move point at all. 

c-n-B observes the motion convention for numeric arguments. 
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Motion up and 
Down Nesting Levels 

c-n-D Down List 

Moves point forward past any intervening Lisp object (excluding a 
list or ni 1) to the level of list structure and leaves point just to 
the right of the open parenthesis of that expression. 

With a numeric argument of n, it moves down n nesting levels. 

c-n-U Backward Up List 

c-n-( 

Backs up out of nesting levels. It moves backward one level of 
list structure. It searches for an open parenthesis and leaves 
point to the left of that open parenthesis. Also, if called inside of 
a string, it moves back up out of that string, leaving point to the 
left of its starting quote. It accepts numeric arguments for 
repetition count. 

With a numeric argument of n, it moves up n nesting levels. 

c-n-) Forward Up List 

Moves forward out of nesting levels. It moves forward one level 
of list structure. It searches for a close parenthesis and leaves 
point to the right of that close parenthesis. Also, if called inside 
of a string, it moves up out of that string, leaving point to the 
right of its ending quote. It accepts numeric arguments for 
repetition count. 

With a numeric argument of n, it moves up n nesting levels. 

Motion Among 
Top-Level Expressions 

A Lisp file contains a sequence of expressions that we call 
top-level expressions, to distinguish them from their own 
subexpressions. Zmacs assumes that top-level expressions begin 
with an open parenthesis against the left margin. It does not 
parse top-level expressions by balancing parentheses, since 
parentheses do not always balance while programs are being 
written. The indentation represents the programmer's conception 
of program structure, and provides a better guide. So by top-level 
expression, we mean a section of text delimited by open 
parentheses at the beginning of two lines. 

In code that includes a string containing a carriage return 
followed by an open parenthesis, show that the open parenthesis 
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does not start a top-level expression by putting a slash in front of 
it. 

c-n-fl Beginning Of Definition 

c-n-C 

Moves point to the beginning of the current top-level expression. 

With a positive numeric argument n, it moves back n top-level 
expressions. With a negative numeric argument -n, it moves 
forward n top-level expressions. 

c-n-E End Of Definition 

c-n-] 

Moves point to the end of the current top-level expression. 

With a positive numeric argument n, it moves forward n top-level 
expressions. With a negative numeric argument -n, it moves back 
71 top-level expressions. 

n-) Move Over ) 

Moves past the next close parenthesis, then does Indent New 
Line. It removes any whitespace between point and the close 
parenthesis before moving over it. With a positive argument /i, 
after finding the next close parenthesis and deleting whitespace 
before it, it moves past n-1 additional close parentheses before 
doing Indent New Line. It ignores numeric arguments that are 
less than 1. 
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Introduction 

A paragraph is delimited by: 

• A newline followed by blanks (spaces or tabs) 

• A blank line 

• A Page character alone on a line 

• Various other mode-dependent factors (for example, a line that 
does not begin with the fill-prefix). See the section "Filling a 
Region", page 109. 

Forward Paragraph 

n-] Forward Paragraph 

Moves the cursor forward one paragraph. 

Numeric arguments are interpreted as repeat counts; negative 
numeric arguments reverse the direction of motion. 

n-] always places the cursor at the end of a paragraph. If the 
cursor is in the middle of a paragraph, n-3 moves the cursor to 
the end of that paragraph. 

Backward Paragraph 

n-C Backward Paragraph 

Moves the cursor one paragraph backward. 

Numeric arguments are interpreted as repeat counts; negative 
numeric arguments reverse the direction of motion. 

n-C always places the cursor at the beginning of a paragraph. If 
the cursor is in the middle of a paragraph, n- [ moves the cursor 
to the beginning of that paragraph. 
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Introduction 



Forward Page 



Pages are delimited by Page characters. You can insert a Page 
character by pressing the PAGE key. The Page delimiter belongs 
to the page that precedes it and is therefore the last character on 
that page. 



c-X ] 



Next Page 



Moves the cursor to the beginning of the next page; that is, puts 
the cursor immediately after the nearest following Page delimiter. 
If the buffer does not contain a Page delimiter, it goes to the end 
of the buffer. 

With a positive numeric argument /i, it repeats this operation n 
times to move forward n pages. A negative numeric argument -n 
moves the cursor backward instead. 

c-X [ always places the cursor immediately to the right of the 
next Page delimiter. If the cursor is immediately to the left of 
the Page delimiter, c-X ] goes to the beginning of the page after 
next rather than just moving forward one character. 



Backward Page 



c-X [ 



Previous Page 



Moves the cursor to the beginning of the previous page; that is, 
puts the cursor immediately after the nearest preceding Page 
delimiter. If the buffer does not contain a Page delimiter, it goes 
to the beginning of the buffer. 

With a positive numeric argument n, it repeats this operation n 
times to move backward n pages. A negative numeric argument 
-n moves the cursor forward instead. 

c-X C always places the cursor at the beginning of a page. If the 
cursor is already at the beginning of the page, c-X [ moves it to 
the beginning of the previous page. 
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Beginning/End of Buffer 

n-< Goto Beginning 

Moves the cursor to the beginning of the buffer. 

With a numeric argument n between and 10, it moves the 
cursor to a place n/10 of the way (counted in lines) from the 
beginning of the buffer towards the end. 

n-> Goto End 

Moves the cursor to the end of the buffer. You can use n-> if 
you are in doubt as to the exact place on the screen where the 
buffer stops. 

With a numeric argument n between and 10, it moves the 
cursor to a place n/10 of the way (counted in lines) from the end 
of the buffer towards the beginning. 



82 

Text Editing and Processing July 1986 



83 

July 1986 Zmacs Manual 



5. Deleting and Transposing Text in Zmacs 



84 

Text Editing and Processing July 1986 



Deleting Vs. Killing Text 



Overview 



Deleting text merely gets rid of it, but Zmacs deletion commands 
not only kill text but also get it back. These commands save 
killed text in a history stack. Other commands, called yanking 
commands, retrieve elements from the history. 

Deletion commands that operate on single characters do not save 
what they delete. However, by giving them a numeric argument, 
thus telling them to delete several characters, they too save the 
deleted text. 

The commands that delete only white space do not save it. 



What Histories Save 

Zmacs uses several histories: 



Type Description 

Kill History of text deleted or saved. The kill 

history is shared with the input editor, thus 
allowing you to move text between files and the 
Lisp Listener. 

Replace History of arguments to Query Replace (n-X) 

and related commands. See the section 
"Searching, Replacing, and Sorting in Zmacs", 
page 113. 

Buffer History of editor buffers visited in this window. 

See the section "Manipulating Buffers and Files 
in Zmacs", page 129. 

Pathname History of file names that have been tjrped. 

Command History of editor commands that use the 

minibuffer, and their arguments. Commands 
that do not use the minibuffer, for example, 
n-RUBOUT, are not recorded in the history. 

Definition History of names of definitions that have been 

typed. 

There is no limit to the length of a history, but the t)^eout 
window displays only the first 25 elements of the history. When 
the history contains more than 25 elements, the screen displays a 
mouse-sensitive line: n more elements in history. Clicking left 
displays the rest of the history. 

Only a single instance of each of these histories exists, shared 
among all editors, including Zmacs, Zmail, and Dired. 
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Kill History 



The kill history contains deleted text and is the history that saves 
the results of the commands described in this chapter. It allows 
you to move text from one editor window to another, for example, 
from the editor to a Lisp Listener. The yanking commands 
described below retrieve elements from the kill history. 



Viewing the Kill History 



You can view and retrieve either the complete kill history or a 
history of all text including a string you specify. 
c-9 c-Y 

Displays the elements of the kill history: 

Kill history: 

1: last piece of killed text 

2: next-to-last piece of killed text 

3: this one is a very long piece of killed text... 



(End of history.) 

Point with the mouse to any element of the history and click left to 
insert it into the current buffer. Only the first 25 elements of the 
history are shown. Click left on (iV more elements in history.) 
to display the rest of the history. 



c-0 c-sh-Y 

Displays the elements of the kill history that match a string you 
supply. For example, if you supply "shift", you might see the 
following: 

Kill history: 



first piece of killed text to click on and shift to someplace else 

Yon Cassius has a lean and shifty look 

Using the shift key with yank commands adds string searching 



(End of history.) 



86 

Text Editing and Processing July 1 986 



Deleting Vs. Killing Text, cont'd. 



Point with the mouse to any element of the history and click left 
to insert it into the current buffer. Only the first 25 elements of 
the history are shown. Click left on (N more elements in 
history.) to display the rest of the history. 



Viewing the Editor 
Command History 

You can view and retrieve either the complete command history 
or a history of all commands including a string you specify. 
c-0 c-n-Y 

Displays the elements of the editor command history: 

Command history: 

1: Control -X Control -F last-file-read-in 

2: Help A 

3: Control -X Control -F other-file-read-in 



(End of history.) 

This command is context-sensitive. When tj^ed at the Lisp 
Listener level, it lists the recent commands typed there. When 
typed at the minibuffer, it lists the history appropriate to what is 
being read in the minibuffer, for example, a pathname or the 
name of a definition. 

The editor history contains only commands that use the 
minibuffer. Commands such as c-N and c-P are not in the 
history. 

c-0 c-n-Y 

Displays the elements of the editor command history that match a 
string you supply. For example, if you supply "sh", you might see 
the following: 
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Command history: 

3: Control -Meta-Shift-Y oregano 

5: Show Mail 

7: Show Spell Dictionaries 
112: Meta-X Finish Patch 



(End of history.) 



This command is context-sensitive. When tj^jed at the Lisp 
Listener level, it lists the matching commands typed there. When 
typed at the minibuffer, it lists the matching history appropriate 
to what is being read in the minibuffer, for example, a pathname 
or the name of a definition. 

The editor history contains only commands that use the 
minibuffer. Commands such as c-li and c-P are not in the 
history. 

Using the Mouse 
on History Elements 

History elements are mouse-sensitive. Click on an element of the 
kill history to yank it to point. Click on an element of the 
command history to reexecute the command. 

Retrieving History Elements 

c-Y Yank 

Yanks back and inserts the last text killed or saved. If you have 
moved point since you killed the text, put point where you want 
the killed text to go before pressing c-Y. Point ends up after the 
text, and mark before the text. An argument of c-U puts point 
before the text instead. A numeric argument of zero displays the 
kill history and does not yank anything. A nonzero numeric 
argument selects an element of the kill history. 

c-sh-Y Yank Matching 

Yanks back and inserts the last text killed or saved that matches 
a string you supply. If you have moved point since you killed the 
text, put point where you want the killed text to go before 
pressing c-Y. Point ends up after the text, and mark before the 
text. An argument of c-U puts point before the text instead. A 
numeric argument of zero displays the kill history and does not 
yank anj^hing. A nonzero numeric argument selects an element 
of the kill history. 
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c-n-Y Repeat Last Minibuffer Command 

Repeats a recent minibuffer command. It yanks the displayed 
default if there is one, otherwise, it yanks the last thing typed in 
this context. A numeric argument n yanks the nth previous one. 
An argimient of lists the history of elements typed in the 
minibuffer. 

For a similar command with string-matching: See the section 
"Repeat Last Matching Minibuffer Command" below. 

c-n-sh-Y Repeat Last Matching Minibuffer Command 

Yanks back and repeats the last minibuffer command that 
includes a string you specify. n-sh-Y yanks back previous 
commands that contain the same string. 

n-Y Yank Pop 

Corrects a yank to use a different element of its history. The 
most recent command must be a yanking command (c-Y, n-Y, 
c-sh-Y, n-sh-Y or c-n-Y). The retrieved item (text or command) 
that was yanked by that command is replaced by the previous 
element of the corresponding history. The history is rotated (that 
is, the elements remain in the same order, but the pointer to the 
current element moves with each successive n-Y) to bring this 
element to the top. 

A numeric argument of zero displays the history. A positive 
numeric argument of n moves n elements back in the history. A 
negative numeric argument moves to a newer history element; 
this only makes sense after you rotate the history. 

n-sh-Y Yank Pop Matching 

Corrects a yank to use a different element of its history. The 
most recent command must be a yanking command (c-Y, n-Y, 
c-sh-Y, n-sh-Y or c-n-Y). If you supplied a matching string in 
the previous command, that string is used. Otherwise, n-sh-Y 
prompts for a string. The retrieved item (text or command) that 
was yanked by that command is replaced by the previous element 
of the corresponding history. The history is rotated (that is, the 
elements remain in the same order, but the pointer to the current 
element moves with each successive n-sh-Y) to bring this element 
to the top. 

A numeric argument of zero displays the history. A positive 
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numeric argument of n moves n elements back in the history. A 
negative numeric argument moves to a newer history element; 
this only makes sense after you rotate the history. 



Kill Merging 



Normally, each kill command pushes a new block onto the kill 
history. However, two or more kill commands in a row combine 
their text into a single element on the history, so that a single 
c-Y command gets it all back as it was before it was killed. This 
means that you do not have to kill all the text in one command; 
you can keep killing line after line, or word after word, until you 
have killed it all, and you can still get it all back at once. 

Commands that kill forward from point add onto the end of the 
previous killed text. Commands that kill backward from point add 
onto the beginning. This way, any sequence of mixed forward and 
backward kill commands puts all the killed text into one element 
without rearrangement. 

If a kill command is separated from the last kill command by 
other commands, it starts a new element on the kill history, 
unless you tell it not to by saying c-n-W (Append Next Kill) in 
front of it. The c-n-W tells the following command, if it is a kill 
command, to append the text it kills to the last killed text, 
instead of starting a new element. With c-n-U, you can kill 
several discrete pieces of text and accumulate them to be yanked 
back in one place. 

c-n-W Append Next Kill 

Makes the next kill command append text to the newest element 
of the kill history. 
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Deleting the Last Character 

RUBOUT Rubout 

Deletes the character immediately to the left of the cursor. 

If the cursor is at the beginning of a line, RUBOUT deletes the 
newline character at the end of the previous line, thus appending 
the current line to the previous one. 

With a positive numeric argument of n, RUBOUT deletes the n 
characters immediately to the left of the cursor. With a negative 
numeric argument of -n, it deletes the n characters immediately 
to the right of the cursor. With any numeric argument, it saves 
the deleted characters on the kill history. 

Deleting the 
Current Character 

c-D Delete Forward 

Deletes the character at the cursor. 

If the cursor is at the end of a line, c-D deletes the newline 
character at the end of the line, thus appending the next line to 
the current one. 

With a positive numeric argument of n, c-D deletes the n 
characters immediately to the right of cursor. With a negative 
numeric argument of -n, it deletes the n characters immediately 
to the left of cursor. With any numeric argument, it saves the 
deleted characters on the kill history. 

Transposing Characters 

c-T Exchange Characters 

Transposes two characters (the ones on each side of the cursor). 

If the cursor is not at the end of a line, c-T transposes the 
character at the cursor and the character to the left of the cursor 
and advances the cursor one character. The result is that the 
character to the left of the cursor has been "dragged" one 
character position to the right. Repeated use of c-T continues to 
pull that character forward. This is useful when you are typing 
and enter two characters in the wrong order (for example, teh for 
the). 

If the cursor is at the end of a line, c-T transposes the two 
preceding characters. 

With a nonzero numeric argument of n, c-T deletes the character 
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to the left of the cursor, moves forward n characters, and 
reinserts the deleted character. When n is negative, the cursor 
moves backwards. 

c-T can only be given a numeric argument of zero when the mark 
is active. In this case, it exchanges the characters at point and 
mark. 
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Introduction 



Deleting the 
Current Word 



For a complete description of how words are delimited: See the 
section "Motion by Word", page 72. 



n-D Kill Word 

Kills the word after the cursor and saves it on the kill history. If 
the cursor is in the middle of a word, n-D kills from the cursor to 
the end of that word. 

With a numeric argument n, it kills n words forward from the 
cursor. If n is negative, it kills backward. 

Deleting the 
Previous Word 

n-RUBOUT Backward Kill Word 

Kills the word before the cursor and saves it on the kill history. 
If the cursor is in the middle of a word, n-RUBOUT kills from the 
cursor to the beginning of that word. 

With a numeric argument n, it kills n words backward from the 
cursor. If n is negative, it kills forward. 

Transposing Words 

n-T Exchange Words 

Transposes the current word and the previous one. If the cursor 
is at the end of a line, n-T transposes the last word on that line 
and the first one on the next, regardless of the amount or type of 
white space between them. 

With a nonzero numeric argument /i, n-T goes to the beginning of 
the current word, deletes the previous word, goes forward n 
words, and reinserts the deleted word. Moving forward a negative 
amount is equivalent to moving backward. An argument of zero 
transposes the words at point and mark. 
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Introduction 

Motion by Lisp expression repositions the cursor according to Lisp 
code delimiters: lists and expressions. A list is something 
enclosed in balanced parentheses. A Lisp expression is any- 
readable printed representation of a Lisp object. 

Deleting the 

Cmrent Lisp Expression 

c-n-K Kill Sexp 

Kills the Lisp expression immediately to the right of point and 
saves it on the kill history. 

With a numeric argument of n, it kills the n succeeding 
expressions. It is an error to kill off the end of a containing 
expression. When the numeric argument is negative, it kills 
backwards from point the same way. 

Deleting the 

Previous Lisp Expression 

c-n-RUBOUT Backward Kill Sexp 

Kills the Lisp expression immediately to the left of point and 
saves it on the kill history. 

With a numeric argument of n, it kills the n preceding 
expressions. It is an error to kill off the beginning of a 
containing expression. When the numeric argument is negative, 
it kills forward from point the same way. 

Deleting the List 
Containing the 
Current Lisp Expression 

Kill Backward Up List (c-n-H) 

Deletes the list that contains the Lisp expression after point, but 
leaves that expression itself. 

Transposing Lisp Expressions 

c-n-T Exchange Sexps 

Point must be between two expressions to use this command. 

Exchanges the two expressions on either side of point, preserving 
current indentation. 

With a numeric argument of /i, it deletes the expression to the 
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left of point, moves forward n expressions, and reinserts the 
deleted expression. With a negative numeric argument, it 
exchanges expressions in the opposite direction. An argument of 
zero transposes the expressions at point and mark. 
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Introduction 



Down Line 



Lines are delimited by special characters called newlines. 



c-N 



Down Real Line 



Moves the cursor straight down to the corresponding column of 
the next line. If the cursor is positioned in the middle of the 
line, c-N moves it to the middle of the next one. 

With a numeric argument n, it nloves the cursor down n lines. 
Moving down a negative number of lines is the same as moving 
up. 



Up Line 



c-P 



Up Real Line 



Moves the cursor straight up to the corresponding column of the 
previous line. If the cursor is positioned in the middle of the 
line, c-P moves it to the middle of the previous one. 

With a numeric argument of n, it moves the cursor up n lines. 
Moving up a negative number of lines is the same as moving 
down. 



Beginning of Line 

c-R 



Beginning of Line 



Moves the cursor to the beginning of the current line. 

With a numeric argument of n, it moves the cursor to the 
beginning of the nth line after the current one, where the current 
line is numbered 1, the preceding line is numbered 0, and so on. 



End of Line 



c-E 

Moves the cursor to the end of the current line. 



End Of Line 



With a numeric argument of n, it moves the cursor to the end of 
the nth line after the current one, where the current line is 
numbered 1, the preceding line is numbered 0, and so on. 



Deleting the 
Current Line 



c-K 



Kill Line 



Kills a line at a time and saves it on the kill history. 



96 

Text Editing and Processing July 1986 



Deleting and Transposing Lines, contu 



If the cursor is at the end of a line, c-K kills the newline, 
merging the current line with the next one. If the cursor is 
elsewhere on the line, c-K kills the text between the cursor and 
the end of the current line. 

With a numeric argument n, c-K kills up to the n.th newline 
following the cursor. When n is negative or zero, c-K kills back 
to the 1-nth. newline before the cursor. c-B c-K kills from the 
cursor back to the beginning of the line that it is on. 

Deleting Backward 
on the Line 

CLEAR IMPUT Clear 

Kills backward to the start of the current line and saves it on the 
kill history. If point is already at the beginning of the line, it 
kills the previous line. With a numeric argument n, it kills 
between point and the start of the nth line above the current line. 
Use CLEAR IMPUT when entering a new line of text, to delete the 
whole line. 



Transposing Lines 
of Te3rt 



c-X c-T Exchange Lines 

Exchanges the current line with the previous one and leaves the 
cursor at the beginning of the next line. 

With a nonzero numeric argument n, c-X c-T deletes the previous 
line (including the following newline), moves down n lines, and 
reinserts the deleted line. 

With a numeric argument of zero, c-X c-T exchanges the lines at 
point and mark, advancing both point and mark to the beginning 
of the next line. 
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Introduction 



According to Zmacs, sentences can end with question marks, 
periods, and exclamation points. Furthermore, these punctuation 
marks only end a sentence when followed by: 

• A newline 

• A space followed by either a newline or another space. 

However, Zmacs allows any number of closing characters, which 
are ", ', ), and ], between the sentence-ending punctuation and the 
white space that follows it. A sentence also starts after a blank 
line. 

This corresponds closely to standard tyiping conventions. Zmacs 
does not recognize a period followed by one space as the end of a 
sentence, for example, as in "e.g. " or "Dr. ". 



Deleting the 
Current Sentence 

n-K 



Kill Sentence 



Kills the text between the cursor and the end of the current 
sentence, and saves it on the kill history. 

With a numeric argument of /i, n-K kills the text between the 
cursor and the end of the nth sentence after the cursor, counting 
the current sentence. If the argument is negative, n-K kills -n 
sentences before the cursor, counting the current sentence. 



Deleting the 
Previous Sentence 

c-X RUBOUT 



Backward Kill Sentence 

Kills backward one sentence and saves it on the kill history. 

With a negative argument, c-X RUBOUT kills forward one sentence 
in a similar manner. 
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What is a Zmacs Region? 



Introduction to Regions 

Many Zmacs commands deal with the region. A region consists of 
a block of information within the buffer that you want to 
manipulate as a single entity. You define the area of the region, 
which can be any size, from characters or chunks of code to pages 
or the entire buffer. 

Zmacs keeps track of one or more locations in a buffer using 
buffer pointers. This section describes: 

• The two buffer pointers named point and mark 

• How Zmacs uses them to define the boundaries of a region 

• The point-pdl, a ring of pointers to saved locations 

• Registers, pointers to locations that you name and save 



The region-manipulating commands 



Point and the Region 

Point (shown by the cursor) is the most important buffer pointer. 
Most editor commands depend on the position of point. Many 
editor commands, invoked by either the mouse or the keyboard, 
can be used to position point to the desired location in the buffer. 
Point points to one end of the region. 

Mark and the Region 

Mark points to the other end of the region. To mark a piece of 
text means to position point and mark on either side of the text, 
making it the region. The simplest way to mark some text is to 
position point (using either the mouse or keystrokes) to one 
boundary (either the beginning or the end) of the text, set the 
mark there (using the Set Pop Mark command), and then 
reposition point at the other boundary. See the section 
"Setting/Popping the Mark", page 102. 

Unlike point, the mark can be active or inactive. When mark is 
active, the region is shown on the screen by underlining. When 
mark is inactive, you cannot see it on the screen unless you 
reactivate it with c-X c-X. Although normally you cannot see an 
inactive mark, Zmacs keeps track of mark when it is inactive and 
sometimes uses mark in its inactive state. For example, c-Y 
leaves point and mark surrounding what it yanks, but does not 
activate mark. c-W immediately following c-Y kills the region 
even though it is not active. c-H c-X after c-Y activates mark, 
making the region visible. However, most commands will not use 
mark or the region unless it is active. You can set the mark 
three ways: when you create a region using the mouse, explicitly 
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with the command Set Pop Mark (c-SPRCE), or with one of the 
commands to mark regions. See the section "Overview of 
Commands to Mark Regions", page 106. When you set the mark, 
you activate it and make the region appear. 

Creating a Region 

You can create a region using either the mouse or keystrokes. 

Creating a Region 
with the Mouse 

The most common way to create a region is with the mouse. 

Hold down the left mouse button and drag the cursor. Let up the 

button to mark the end of the region. 

Holding down the middle mouse button creates a region, too. It 
marks the "thing" you point the mouse at, "thing" being mode- 
dependent (a word or Lisp expression if you point with the mouse 
at text, or a line if you point with the mouse at white space 
before or after all the text on the line). 



Creating a Region 
with Keystrokes 



The Point-pdl 



You can also create a region using keystrokes. After setting the 
mark, you can move point either forward or backward to define a 
region in either direction; as you do so, Zmacs highlights the 
region with underlining. 

Typing a self-inserting character or c-G deactivates the mark and 
removes the underlining that highlights the region. The mark 
does not have an associated cursor like point. When inactive, the 
mark is invisible, but you can go to it with c-X c-X, Swap Point 
And Mark. 



Zmacs maintains a special stack of buffer pointers called the 
point-pdly where pdl stands for push-down list, another name for a 
stack. 

Zmacs automatically saves point on the point-pdl as it executes 
some commands (for example, n-<) that move point great 
distances. Whenever Zmacs pushes point onto the point-pdl, it 
displays "Point pushed" in the echo area, moves point to its new 
location, and pushes the previous point down onto the point-pdl. 

By popping the point-pdl, that is, resetting point to its last 
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location as recorded on the point-pdl, Zmacs returns point to 
where it was when the pdl was last pushed. 

Setting/Popping 
the Mark 

c-SPflCE Set Pop Mark 

With no argument, c-SPRCE does three things: 

1. Puts mark where point is 

2. Makes mark active 

3. Pushes point onto the point-pdl 

Other commands can do each of these operations separately. 
Creating a region with the mouse sets a mark and makes it active 
but does not push point. 

This command does other things depending on how many c-Us are 
typed in front of it: 

Argument Action Taken 

one c-U Pops the location on the top of the point-pdl into 

point (typically puts point where it set the last 
mark). 

two c-Us Pops the location on the top of the point-pdl and 

throws it away. 



Moving to 
Previous Points 

c-n-SPRCE Move to Previous Point 

Exchanges point and top of point-pdl. With a numeric argument 
n, it rotates a ring consisting of point and the top n-1 elements of 
point-pdl; thus the default argument is 2. With a numeric 
argument of 1, it rotates the entire point-pdl. A negative numeric 
argument rotates the ring in the other direction. 

c-X c-n-SPRCE Move to Default Previous Point 

Rotates the point-pdl, the same as c-n-SPRCE except that 
c-X c-n-SPRCE has a default of 3. A numeric argument specifies 
the number of entries to rotate and sets the new default before 
rotating the point-pdl. 
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Showing the Mark 

c-X c-X Swap Point And Mark 

Exchanges point and mark. It works even when no region is 
active. It highhghts the text between point and mark. 

With an argument, it does not exchange point and mark, but 
instead it highlights the text between point and mark. 
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Saving and 

Moving to 

Locations in Registers 

You can assign one-character "names" to locations in the buffer, 
which can be helpful for setting up a series of places in your text 
to which you want to return for some reason - to double-check 
several items without interrupting your text entry or editing, if 
you are considering a format change that will affect several 
parallel points, or simply to return quickly and easily to rough 
spots that require further work. 

c-X S Save Position 

Saves the current location in a register. It prompts for a one- 
character register name. 

c-H J Jump to Saved Position 

Moves point to a position that was saved in a register. It 
prompts for a register name and switches buffers to move to the 
saved position, if necessary. 

Saving and 
Inserting Regions 
in Registers 

c-H X Put Register 

Copies the text of the region into a register. It prompts for a 
register name. With a numeric argument, it deletes the region 
from the buffer after copying it. 

c-H G Open Get Register 

Inserts text from a specified register into the buffer. It prompts 
for the name of the register. It overwrites blank lines in the 
buffer the way RETURM does (using the command Insert Crs). It 
leaves the mark before the inserted text and point after it. With 
a numeric argument, it puts point before the text and the mark 
after. 

List Registers (n-X) 

Displays names and contents of all defined registers. It shows 
the name of the register and whether it contains a position or 
text. If the register contains a position, it tells which character 
on the line the position is at, and shows the first 50 characters 
on that line. If the register contains text, it shows the first 50 
characters on the first line of that text. 
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List of all registers: 

D (text) This text was marked as a region and saved here 

1 (position) Char B. in "another line containing a position" 

Done. 



Show Register (n-X) 

Displays the contents of a register in the t3^eout window. It 
prompts for a register name and then tells whether the register 
contains a position or text: 

Register A contains a position: Character 9 in this line: 

this is the line 

or 

Register A contains text: 



Kill Register (n-X) 
Kills a register. 
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Overview 



To mark a piece of text means activating mark and then 
positioning point and mark on either side of the text, making it 
the region. The simplest way to mark some text is to go to one 
end of the text, set the mark there (using the Set Pop Mark 
command), and go to the other end of the text. See the section 
"Setting/Popping the Mark", page 102. However, several 
convenient commands mark different specific amounts of text: 





n-@ 


Marks a word. 




c-n-@ 


Marks an expression. 




c-n-H 


Marks a definition. 




n-H 


Marks a paragraph. 




c-X c-P 


Marks a page. 




c-X H 


Marks the whole buffer. 




c-> 


Marks to the end of the buffer. 




c-< 


Marks to the beginning of the buffer. 


Marking Words 







n-@ 



Mark Word 



Puts the mark at the end of the current word. With a numeric 
argument of n, n-@ puts the mark n words forward from point. 



Marking Lisp Expressions 

c-n-@ 



Mark Sexp 

Marks the current expression by putting mark at the end. 

With a numeric argument /i, it moves forward n expressions and 
puts the mark there. For a more detailed description of how to 
move forward n expressions: See the section "Motion by Lisp 
Expression", page 76. 



c-n-H 



Mark Definition 



Puts point and mark around the current definition. 
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Marking Paragraphs 

n-H Mark Paragraph 

Puts the mark at the end of the current paragraph and moves 
point to the beginning, so that the current paragraph becomes the 
region. With a numeric argument n, n-H puts point at the 
beginning of the current paragraph and marks n paragraphs 
forward from there. 



Example 



n-3H marks the current paragraph and the following two; n- -IH 
marks the preceding paragraph. When marking preceding 
paragraphs, point is left at the end of the region, and when 
marking current and succeeding paragraphs, point is left at the 
beginning of the region. 

Marking Pages 

c-H c-P Mark Page 

Puts the mark at the end of the current page and moves point to 
the beginning, so that the current page becomes the region. 

With a numeric argument of n, c-X c-P marks the nth page after 
the current one. If n is zero, this is the current page; if n is 
negative, this page comes before the current page. 

Marking Buffers 

c-X H Mark Whole 

Marks the whole buffer by putting point at the beginning and the 
mark at the end. 

With any numeric argument, c-X H puts the mark at the 
beginning and point at the end. 

Marking to End of Buffer 

c-> Mark End 

Marks from the cursor to the end of the buffer by putting the 
mark at the end of the buffer. 
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Marking to 
Beginning of Buffer 

c-< Mark Beginning 

Marks from the cursor to the beginning of the buffer by putting 
the mark at the beginning of the buffer. 
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Saving a Region 

n-W Save Region 

Puts region on kill history list without deleting it. For 
information on kill merging and the Append Next Kill command, 
c-n-W: See the section "Kill Merging", page 89. 

Deleting a Region 

c-W Kill Region 

Deletes the region. If there is no region, c-W produces an error. 

This command ignores numeric arguments and places the deleted 
text on the kill history list. For information on retrieving history 
elements and the Yank command, c-Y: See the section 
"Retrieving History Elements", page 87. 

Compiling a Region 

c-sh-C Compile Region 

Compile Region (n-X) 

Compiles the region, or if no region is defined, the current 
definition. 

Transposing Regions 

c-« T Exchange Regions 

Exchanges two regions delimited by point and last three marks. 

After transposing regions, you can undo the effect of this 
command by invoking it again. 

Hardcopying a Region 

Hardcopy Region (n-X) 

Sends a region's contents to the local hardcopy device for 
printing. 

For full information on Genera hardcopying: See the section 
"How to Get Output to a Printer" in User's Guide to Symbolics 
Computers. 

Filling a Region 

When Zmacs fills text it breaks it up so that it does not extend 
past the fill column. The fill column determines the right 
margin, and is the first column in which text is not to be placed 
by n-Q, n-G, or Auto Fill Mode formatting. In addition, the fill 
prefix, if set, is inserted: 
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• At the beginning of each new line typed in while in Auto Fill 
Mode 

• At the beginning of each line in a paragraph for n-Q and each 
line in a region for n-G 

The fill prefix determines the left margin, and is empty unless set 
to contain some combination of spaces and characters. If you do 
not set the fill prefix, the left margin is the left edge of your 
Zmacs window. For example, to insert five spaces at the 
beginning of every line, insert them at the beginning of the 
current line, and with point at column six, use c-X .. To turn 
this fill prefix off, put point at the beginning of a line, and use 
c-K . again. 

Adjusting or justifying text inserts extra spaces between the words 
to make the right margin come out exactly even. 

n-Q Fill Paragraph 

Fills the current (or next) paragraph. A positive argument means 
to adjust rather than fill. 

n-G Fill Region 

Fills the current region. A positive argument means to adjust 
rather than fill. 

c-X . Set Fill Prefix 

Defines Fill Prefix from the current line. All of the current line 
up to point becomes the Fill Prefix. Fill Region starts each 
nonblank line with the prefix (which is ignored for filling 
purposes). To stop using a Fill Prefix, do a Set Fill Prefix at the 
beginning of a line. 

Other Region- 
related Commands 

For descriptions of the following commands: 

Name and Invocation 
Uppercase Region c-X c-U 
Lowercase Region c-X c-L 
Uppercase Code in Region (m-X) 
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Lowercase Code in Region (n-X) 

See the section "Changing Case of Regions in Zmacs", page 214. 
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Searching in Zmacs 



Overview 

Like other editors, Zmacs has commands for searching for an 
occurrence of a string. Zmacs search commands are incremental; 
that is, they begin to search as soon as you type the first 
character. 

This section describes how to search incrementally forward and 
backward in the buffer, as well as a method for specifying a 
complete search string first and then specifying a direction in 
which to search. 

Incremental Search 

The command to search is c-S (Incremental Search). c-S reads 
in characters and positions the cursor at the first occurrence of 
the characters that you have typed. If you type c-S and then t, 
the cursor moves right after the first t. Type an r, and see the 
cursor move to after the first tr. Add a y and the cursor moves 
to the first try after the place where you started the search. At 
the same time, the try has echoed at the bottom of the screen. 
Stop typing when you have typed enough characters to identify 
the place you want. 

You can rub out any character you type. After the try, pressing 
RUBOUT makes the y disappear from the bottom of the screen, 
leaving only tr. The cursor moves back to the tr. Rubbing out 
the r and t moves the cursor back to where you started the 
search. To exit from the search, press END or ESCRPE. You can 
also use ABORT to exit from the search. To abort out of the 
search and return to the original starting point in the buffer, use 
c-G. 

If you want to search for something else, press CLERR INPUT to 
erase the current search string. You are still in the search loop, 
so type another search string. 

If the string cannot be found with c-S, type c-R to search 
backward for the default string. Zmacs remembers the default 
search string - you can reinvoke the search at any time using 
c-S c-S, to search forward for it, or c-R c-R to search backward. 

c-S Incremental Search 

Searches for a character string while you t5T)e it, searching 
forward to the end of the buffer. It prompts for a string in the 
echo area with I -Search:. As you type characters in, c-S displays 
the accumulating string in the echo area and searches for it at 
the same time. If no string is found, it displays Failing I- 
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Search : . When it locates the string, it puts the cursor after it so 
that repeated c-Ss locate subsequent occurrences of the default 
string in the buffer. 

RUBOUT Removes a character and backs up the search to 

the last match. 

ESCAPE When typed before any search characters, 

switches to String Search. See the section 
"Zmacs String Search", page 116. 

END or ESCAPE Exits the search. 

c-G Exits the search and returns to original starting 

point in the buffer. 

c-Q Quotes the next character, to prevent it from 

terminating the search. 

c-S Repeats the search. 

c-R Reverses the search to search backwards. 

If c-S or c-R is the first character typed, the previous search 
string is used again as the default. Entering any other command 
character terminates the search (and then executes that 
command). 

Reverse 
Incremental Search 

c-R, Reverse Incremental Search, works exactly the same way as 
c-S, Incremental Search, except that it searches backward towards 
the top of the buffer from point, instead of forward. 

c-R Reverse Incremental Search 

Searches for a character string while you type it, searching 
backward to the beginning of the buffer. It prompts for a string 
in the echo area with Reverse I -Search:. As you type characters 
in, c-R displays the accumulating string in the echo area and 
searches for it at the same time. If no string is found, it displays 
Failing Reverse I -Search:. When it locates the string, it puts 
the cursor in front of it so that repeated c-Rs locate previous 
occurrences of the default string in the buffer. 

RUBOUT Removes a character and backs up the search to 

the last match. 
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ESCAPE When typed before any search characters, 

switches to Reverse String Search. See the 
section "Zmacs String Search", page 116. 

END or ESCRPE Exits the search. 

c-G Exits the search and returns to original starting 

point in the buffer. 

c-Q Quotes the next character, to prevent it from 

terminating the search. 

c-S Reverses the search to search forward. 

c-R Repeats the search. 

If c-S or c-R is the first character typed, the previous search 
string is used again as the default. Entering any other command 
character terminates the search (and then executes that 
command). 



String Search 



The string search command, invoked by c-S ESCAPE, lets you t3T)e 
in the entire string and specify the direction in which to search 
before starting the search. 

c-S ESCAPE String Search 

Searches for a specified string, according to the arguments given 
with the special characters below. Another c-S always begins the 
search. It prompts in the echo area String Search: It saves 
previous string search commands on a ring, retrievable with c-D. 
The ring contains three elements and can be rotated with 
repeated c-Ds. While you are entering the search string, the 
following characters have special meanings: 

c-B Searches forward from the beginning of the 

buffer. 

c-E Searches backwards from the end of the 

buffer. 

c-F Leaves point at the top of the window, if the 

window must be recentered. 

c-G Aborts the search. 

c-D Gets a string to search for from the ring of 

previous search strings. 
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c-L Redisplays the typein line. 

c-Q Quotes the next character. 

c-R Reverses the direction of the search. 

c-S Does the search, then comes back to the 

search command loop. 

c-U or CLEAR INPUT Erases all characters typed so far. 

c-U Delimited Search: Searches for occurrences 

of the string surrounded by delimiters. 

c-W Word Search: Searches for words in this 

sequence regardless of intervening 
punctuation, white space, newlines, and 
other delimiters. 

c-Y Appends the string on top of the string ring 

to the search string. 

RUBOUT Rubs out the previous character typed. 

END or ESCRPE Does the search and exits. 

If you search for an empty string, it uses the default. Otherwise, 
the string you type becomes the default, and the default is saved 
unless it is a single character. 
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Overview of 

Locating and 

Replacing Strings Automatically 

c-7., Replace String, searches forward for a string and replaces 
that string with another, c-?. prompts for the string to be 
replaced, reads the string from the minibuffer, and then reads the 
replacement string. After it goes through the buffer trjdng to 
make the replacements, it tells you how many replacements it 
made (1 . replacement.), or that it made none. 

You can also substitute one string for another selectively 

throughout the buffer, with n-?., Query Replace. n-P. prompts 

first for the string to be replaced 

(Query-replace some occurrences of:), and then for the string to 

replace it with 

(Query-replace some occurrences of "string" with:). Terminate 

each string you specify with RETURN, n-?. locates each occurrence 

and lets you decide what to do about each one. 

Making Global 
Replacements in Zmacs 

c-?. Replace String 

Replace String (n-X) 

Replaces all occurrences of a given string with another, where the 
string can be characters, words, or phrases. It prompts first for 
the string to remove and second for the string to replace it with. 
A numeric argument n means to make n replacements. By 
default, it begins at point and replaces all occurrences of the first 
string that occur after point in the buffer. Usually it attempts to 
match the case of the replacements with the case of the string 
being replaced. This behavior is controlled by the Zmacs variable 
Case Replace P (default t). When it is null, case matching does 
not take place. (For descriptions of Zmacs variables: See the 
section "How to Specify Zmacs Variable Settings", page 269.) 

Querying While 
Making Global 
Replacements in Zmacs 

n-?. Query Replace 

Query Replace (n-H) 

Starting at point, replaces a string through the rest of the buffer, 
asking about each occurrence, where the string can be characters, 
words, or phrases. It prompts for each string. You first give it 
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STRING1, then STRING2, and it finds the first STRING1, displaying it 
in context. You respond with one of the following characters: 

SPACE Eeplaces it with STRING2 and shows next 

STRING1. 

RUBOUT Leaves this STRING1, but shows next STRING1. 

, Replaces this STRING1 and shows result, waiting 

for a SPACE, c-R, or ESCAPE. 

Period Replaces this STRING1 and ends query replace. 

c-G Leaves this occurrence of STRING1 unchanged 

and terminates the query replace. 

ESCAPE Same as c-G. 

Returns to site of previous STRING1. 

c-U Kills this STRING1 and enters recursive edit. 

c-R Enters editing mode recursively. Press EMD to 

return to Query Replace. 

c-L Redisplays screen. 



J 



Replaces all remaining ST RING Is without asking. 



Entering any other character terminates the command. Usually 
the command attempts to match the case of the replacements 
with the case of the string being replaced. This behavior is 
controlled by the Zmacs variable Case Replace P (default t). 
When it is null, case matching does not take place. (For 
descriptions of Zmacs variables: See the section "How to Specify 
Zmacs Variable Settings", page 269.) 

If you give a numeric argument, it does not consider STRINGIs 
that are not bounded on both sides by delimiter characters. 

Querying While 
Making Multiple 
Global Replacements 

While doing multiple query replacements, you can specify the 
replacement strings either from the minibuffer or from another 
buffer altogether. 

Multiple Query Replace (n-X) 

Performs query replace using many pairs of strings at the same 
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time, where the strings can be characters, words, or phrases. 
(See the section "Querjdng While Making Global Replacements in 
Zmacs", page 118.) Strings are read in alternate minibuffers; when 
you finish entering all strings, press RETURN twice. An argument 
means that the strings must be surrounded by delimiter 
characters. A negative argument means that the strings must be 
delimited Lisp objects (not lists), rather than words. 

Multiple Query Replace From Buffer (n-X) 

Performs query replace using many pairs of strings supplied from 
the specified buffer. (See the section "Querying While Making 
Global Replacements in Zmacs", page 118.) The current buffer 
should contain a STRING1, a space, and a STRINGS. Put quotation 
marks around any string that contains a space, tab, backspace, 
semicolon, or newline character. Lines in the buffer that begin 
with a semicolon or are blank are ignored. In other words, each 
string in the buffer is a Lisp string, but quotation marks can be 
omitted if the string contains no special characters. 

Other Types of 
Replacement 
Operations in Zmacs 

Besides making string replacements in text, Zmacs commands 
replace: 

• A region into the kill history 

• Evaluated code into the buffer 

• The value of LET into its variable 

• A string for delimited Lisp objects (not lists or nil) 

Query Replace Last Kill 

Query Replace Last Kill (n-X) 

Replaces the first item in the kill history with the region. 

Evaluate and 
Replace Into Buffer 

Evaluate And Replace Into Buffer (n-X) 

Evaluates the Lisp object following point in the buffer and 
replaces it with its result. 
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Query Replace LET Binding 

Query Replace Let Binding (n-X) 

Replaces variable of LET with its value. Point must be after or 
within the binding to be modified. 

Atom Query Replace 

Atom Query Replace (n-X) 

Performs query replace for delimited Lisp objects (except for lists 
or nil). (See the section "Querjdng While Making Global 
Replacements in Zmacs", page 118.) 
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Introduction 

Tag tables, a means of global searching and replacing, allow you 
to make sweeping changes to groups of files without having to 
explicitly locate each file. A tag table is a Zmacs support buffer, 
(a temporary buffer), that contains the names of sets of buffers 
and files, which you specify. You can edit these specified buffers 
and files as a unit, once you have specified them as items in a 
tag table. Tag tables remain active for the duration of the Zmacs 
session; you cannot permanently save tag tables. 

You could use tag tables, for example, to: 

• Search for all references to a certain variable and alter them 
consistently 

• Search for all occurrences of an obsolete term and update it 

• Search for all functions that send a certain message 

How Tag Tables Work 

First, you specify the buffers or files that will make up the tag 
table. See the section "Specifying and Listing Tag Tables", page 
122. Then you can perform an operation. See the section 
"Performing Operations with Tag Tables", page 123. Zmacs 
performs the operation on the files within the tag table that you 
have specified. 



Example 

Suppose you want to perform a tag query replace in several files. 
Use Tags Query Replace (n-H) to begin: See the section 
"Performing Operations with Tag Tables", page 123. The 
minibuffer prompts as in Query Replace (n-X) for the string to be 
replaced and the replacement string. The operation begins and 
Zmacs displays Control-, is now Continue query replacement of 
"string-old" with "string-new"; as it displays each occurrence, 
you deal with each one using the appropriate response characters. 
Tags Query Replace goes through all the files specified in the tag 
table, listing their names in the minibuffer and stopping at each 
occurrence of "string-old". Wlien it finishes searching all the 
files, it displays No more files. 

Specifying and 
Listing Tag Tables 

Select All Buffers As Tag Table (n-X) 

Selects all buffers currently read in. It creates a support buffer 



123 

July 1986 Zmacs Manual 



Tag Tables and Search Domains, contu 



called ^Tag-Table-iV*, which contains a list of the names of all 
the buffers. See the section "Support Buffers", page 126. 

Select Some Buffers As Tag Table (n-X) 

Selects some buffers currently read in, querying about each one. 
With a numeric argument, it asks only about buffers whose name 
contains a given string. 

Select Tag Table (n-X) 

Makes a tag table current for commands like tag search. It 
prompts in the minibuffer for the name of the tag table to use. 

Select System As Tag Table (n-X) 

Creates a tag table for all files in a system defined by defsystem. 
It prompts in the minibuffer for the name of a system - press 
HELP to see a display of system names. It selects the system but 
does not read the files in (use Find Files in Tag Table (n-X) to 
read them in). 

List Tag Tables (n-X) 

Lists in the t3T)eout window the names of all the tag tables, and 
for each one shows the files it contains. 

Performing 
Operations with 
Tag Tables 

Tags Search (n-X) 

Searches for the specified string within files of the tag table. It 
prompts in the minibuffer for the search string. If there is no 
current tag table, it prompts for one. 

Zmacs displays in the echo area the name of each of the files in 
the tag table as it searches each file for the specified string. As 
Zmacs begins the operation and finds the first occurrence, it 
displays Point pushed, in the minibuffer and moves the cursor to 
the occurrence. After you deal with that occurrence, use c-., the 
Next Possibility command, to tell locate the next occurrence. (See 
the section "Displaying the Next Possibility", page 126.) Go 
through the specified files using c-. to the end. 

Tags Query Replace (n-X) 

Replaces occurrences of one string with another within the files 
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of the tag table, asking about each occurrence. It prompts first 
for the string to remove and second for the string to replace it 
with. You first give it STRING1, then STRING2, and it finds the 
first STRING1, displaying it in context. You respond with one of 
the following characters: 



SPRCE 



RUBOUT 



Period 

c-G 

ESCAPE 

c-W 
c-R 

c-L 



Replaces it with STRING2 and shows next 
STRING1. 

Does not replace this occurrence, but shows 
next STRING1. 

Replaces this STRING1 and shows result, waiting 
for a SPACE, c-R, or ESCAPE. 

Replaces this STRING1 and terminates the query 
replace. 

Leaves this occurrence of STRING1 unchanged 
and terminates the query replace. 

Same as c-G. 

Returns to site of previous STRING1 (actually, 
pops the point-pdl). 

Kills this STRING1 and enters recursive edit. 

Enters editing mode recursively. Press END to 
return to Query Replace. 

Redisplays screen. 

Replaces all remaining STRINGIs without asking. 



Entering any other command character terminates the command. 
Usually the command attempts to match the case of the 
replacements with the case of the string being replaced. This 
behavior is controlled by the Zmacs variable Case Replace P 
(default t). When it is null, case matching does not take place. 
(For descriptions of Zmacs variables: See the section "How to 
Specify Zmacs Variable Settings", page 269.) 

If you give a numeric argument, it does not consider STRINGIs 
that are not bounded on both sides by delimiter characters. 



Tags Multiple Query Replace (n-X) 

Performs tags query replace using many pairs of strings at the 
same time, where the strings can be characters, words, or 
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phrases. Strings are read in alternate minibuffers; when you 
finish entering all strings, press RETURM twice. An argument 
means that the strings must be surrounded by delimiter 
characters. A negative argument means that the strings must be 
delimited Lisp objects (excluding lists and nil), rather than words. 

Tags Multiple Query Replace From Buffer (n-«) 

Replaces occurrences of any number of strings with other strings 
within the tag table files, asking about each change. The current 
buffer should contain a STRING1, a space, and a STRING2. Put 
quotation marks around any string that contains a space, tab, 
backspace, semicolon, or newline character. Lines in the buffer 
that begin with a semicolon or are blank are ignored. In other 
words, each string in the buffer is a Lisp string, but quotation 
marks can be omitted if the string contains no special characters. 

A positive numeric argument means to consider only the cases 
where the strings to replace occur as a word (rather than within 
a word). A negative numeric argument means to consider only 
delimited Lisp objects (excluding lists and nil), rather than words. 

This command has the same options as Tags Query Replace. 

Find Files in Tag Table (n-H) 

Reads every file in the selected tag table into the editor. If there 
is no current tag table, it prompts for the name of one, which you 
can specify as a file (F), all editor buffers (B), or a system (S). 

Visit Tag Table (n-«) 

Creates a tag table by reading in a PDP-10 Emacs tag file. Tag 
files provide a list of the names of files that belong together as 
part of a system and a list of names and locations of definitions 
within the files. The file names are made into a tag table; the 
definition names are added to the completion table. 

First, it reads in the specified tag file. It prompts for a file name 
from the minibuffer. Next, it goes through the tag file and 
marks the name of each tag as being a possible section of its file. 
The Edit Definition command (n-.) uses these marks to figure 
out which file to use. 

It uses a support buffer to hold the elements of the tag table and 
another support buffer to hold the state of a pending operation 
involving all the files in the tag table. See the section "Support 
Buffers", page 126. Each contains the names of the files. 
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Support Buffers 

Zmacs creates support buffers to save lists that it creates as part 
of the execution of some commands: 

• Tag table commands. 

• Edit Buffers (n-H). 

• View File (n-X). 

• Lists for Edit Definition (n--), when more than one definition 
exists. 

• Buffers for Dired (n-X). 

• Everything that edits a sequence of definitions, as in List 
Callers (m-X) or List Methods (n-X). 

This means that you can examine the buffers containing the lists 
even after you have done some editing. 

c-X c-B, the List Buffers command, displays these support buffers 
in the listing of buffers. Their names are, for example, 
*Definitions-1*, *Tags-Search-1*, and *Tags-Query-Replace-1*. 

To avoid proliferation of editor buffers, Zmacs reuses support 
buffers in most cases, so that it usually saves no more than two 
of each t3T)e of support buffer at a time. 

Possibility Buffers 

Each time you use a command that generates a set of possibilities 
(for example. Tags Search (n-X) and Tags Query Replace (n-X)), it 
creates a possibility buffer for that set and pushes the set of 
possibilities onto a stack, c-., Next Possibility, extracts the next 
item from the set at the top of the stack. The set is popped from 
the stack when no more items remain in it. Several informational 
messages are associated with this facility. When the whole 
possibilities stack is empty and you have nothing more pending it 
displays: 

No more sets of possibilities. 



Displaying the Next Possibility 

C-, Next Possibility 

Selects the next possibility for the current set of possibilities. 
With a negative argument, pops off a set of possibilities. An 
argument of c-U or any positive number displays the remaining 
possibilities in the current set. With an argument of zero, selects 
the current buffer of possibilities. 



127 

July 1986 Zmacs Manual 



Tag Tables and Search Domains, contu 



For a description of the Edit Definition and Edit Callers 
commands: See the section "Editing Lisp Programs in Zmacs", 
page 223. 



Example 



Suppose you had been using c-. to move through the set provided 
by Tags Search and you then used Tags Query Replace to push a 
new set of possibilities onto the stack. When you finished the set 
provided by Tags Query Replace, you would see a message like 
the following to notify you that the empty set had been popped off 
the stack and the set of possibilities for Tags Search had been 
reinstated.: 

C-- is now Search for next occurrence of "string" 

The position of point in the support buffer indicates the next item 
for Next Possibility (c--). You can select the support buffer and 
move point manually in order to skip or redo possibilities. 

Typing c- . while in a support buffer that is not at the top of the 
possibilities stack moves it to the top, prints an appropriate 
message, then takes the next possibility from that support buffer. 
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Overview 

The Zmacs sorting commands alphabetically sort a region by line, 
paragraph, or whatever sort key you specify. 



Zmacs Sorting Commands 

Sort Lines (n-X) 



Sorts the region alphabetically by lines. 



Sort Paragraphs (n-X) 

Sorts the region alphabetically by paragraphs. 

Sort Via Keyboard Macros (n-H) 

Sorts the region, prompting for actions to define the records (the 
units of the region to be rearranged) and the sort keys (the fields 
in the records that are compared alphabetically to determine the 
new order of records). It prompts you to define the records and 
sort keys by performing positioning commands. It prompts for 
three actions: 

1. Move to the beginning of the sort key (that is, move the cursor 
to the beginning of the field upon which to sort). 

2. Move to the end of the sort key (that is, move to the end of 
the sort field). 

3. Move to the end of the sort record (that is, move to the end of 
the record containing that field). 

For each, it records the keystrokes that you use (as keyboard 
macros) and plays those back to find and sort the records in the 
region. 
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Overview 

Files are semipermanent collections of information stored safely 
outside the Zmacs environment. Buffers, on the other hand, are 
more dynamic, temporary collections of information, used by 
Zmacs for manipulating text. Buffers live in the active Zmacs 
environment. Each buffer has its own point and mark as well as 
other associated information. 

We say we use Zmacs to "edit files", but what we really do is 
copy a file into a buffer created for the purpose, edit the buffer, 
and then write out a new version of the file from the edited 
buffer. The old version of the file is retained, to be deleted 
explicitly when appropriate. Successive versions of files are 
distinguished by version number, a component of the file name 
that is incremented with each new revised copy (except on file 
server hosts such as UNIX that do not have version numbers). 

Zmacs allows multiple buffers, so that you can edit many files 
simultaneously. Usually only one buffer is visible on the screen at 
a time. You can, however, divide the screen into multiple 
windows so that you can view the contents of several buffers at 
once. 

Zmacs keeps track of the association between files and buffers. If 
you are editing a file's contents in a buffer, Zmacs gives that 
buffer the same name as that of the file being edited. 

Buffer and File Names 

Both buffers and files have long names that indicate the host 
directory as well as the file name (and version, where supported). 
Hence completion is a necessary aid and is always provided for 
entering buffer and file names. 

Buffer Flags for 
Existing Files 

Each buffer has a modification flag that tells whether the buffer 
has been changed to be different from the associated file. You 
can see the modification flag by clicking on either the List 
Buffers command or the Kill or Save Buffers command in the 
editor menu (editor menu is click right once), or by pressing c-X 
c-B for List Buffers. 

The modification flag is cleared when: 

• The file is read into the buffer from the file system. 

• The buffer is saved, that is, whenever its contents are written 



131 

July 1986 Zmacs Manual 



Working with Buffers and Files, confw. 



out to the associated file. As soon as its contents are modified 
thereafter, the modification flag is set and Zmacs displays an 
asterisk (*): (1) in the mode line to the right of the buffer 
name, and (2) whenever it displays output from the List Buffers 
command. 

Buffer Flags for 

New Files 

The List Buffers (c-X c-B) command uses the plus sign (+) to 
mark new files that have not been saved. In addition, it uses + to 
mark new buffers, not associated with files, that have text in 
them. This helps when you put text into a new buffer and later 
want to be reminded to write that buffer to a file. 
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Current Buffer 



Buffer History 



At all times when using Zmacs, you have one selected buffer, 
which is the buffer that you are actively editing. This is the 
buffer in which all current activity takes place until you switch 
buffers. 



With a single Zmacs window on the screen, the editor keeps one 
buffer history, the global history list, which remembers the 
previous-buffer history (stack history) of that window. The top 
buffer in the stack is the currently selected one. Usually, when a 
buffer is selected, it is pulled out of the stack and put on top. 
The buffers near the top are usually the most recently used. 
Each time you change buffers Zmacs offers the name of the most 
recently used buffer as the default buffer name. 

When we refer to the nth. buffer, we mean the nth buffer in 
Zmacs's stack of buffers. 

Every additional window maintains its own buffer history, but the 
global history list continues to display an entry for every buffer in 
every window. 

When you create a new window, Zmacs initially takes the history 
list for the new window from the global history list. From then 
on, as you switch from buffer to buffer within that window, the 
list for that window reflects the history of those changes in 
chronological order. This affects particularly c-n-L (Select 
Previous Buffer) and the default for c-H B (Select Buffer). 

The global history list still exists and is used for name completion 
and c-H c-B (List Buffers). 
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Changing Buffers 

c-X B Select Buffer 

Prompts for the name of a buffer and selects that buffer, 
displaying its contents on the screen. If you press END or RETURN 
instead of a name, it reselects the second most recently selected 
buffer. 

Using completion, it takes the string you enter and tries to 
complete it to an existing buffer name: 

• When completion is successful, it selects that buffer. 

• When completion is unsuccessful, (there is no buffer with the 
name given), it either waits for you to type more characters (if 
there are multiple possible completions) or it beeps to give you 
a chance to correct a typing error (if there is no possible 
completion). A subsequent response of c-RETURN creates a new 
buffer with the specified name and selects it. 

If you precede the c-X B command with a numeric argument, 
Zmacs prompts for the name of the buffer and then creates and 
selects it. 

c-n-L Select Previous Buffer 

Selects a previously selected buffer. With a numeric argument n, 
it selects the nth previous buffer. The default argument is 2. 
When the argument is 1, it rotates the entire buffer history. A 
negative argument means to rotate the other way. An argument 
of zero displays the buffer history, which is mouse sensitive. 

c-X c-n-L Select Default Previous Buffer 

With a numeric argument m, this is exactly the same as c-n-L. 
Without a numeric argument, this command remembers the last 
numeric argument it received and uses that as its argument this 
time. 

This is useful if you happen to be working with the top few 
buffers on the buffer stack and want to cycle among them without 
having to remember how many there are. 



Listing Buffers 



c-X c-B List Buffers 

Lists all the currently existing buffers in the typeout window, 
along with the editor mode of the buffer and the name of the 
associated file, if any. For buffers with associated files, it 
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displays the version number of the file, if any. If there is no 
associated file, c-X c-B gives the size of the buffer in lines 
instead. For Dired buffers, it displays the pathname used for 
creating the buffer. It lists modified buffers with an asterisk. It 
lists the buffers sorted in stack order. You can inhibit this 
sorting by setting the global variable 
zwei:*sort-zmacs-buffer-list* to nil (default is t). 

With an argument of c-U, it prompts for a substring and then 
lists only buffers whose names contain that substring. 

The buffer names are mouse sensitive. Click right on the name 
of the buffer for a menu of operations (Kill, Not Modified, Save, 
Sel ect) for that buffer. You can select one of the buffers by 
clicking left on its name. 



Example 



Buffers in Ztnacs; 
Buffer name: 



File Version; 



Major mode; 



+ filel /dess/zmacs VIXEN: 
= *Dired-1* 

* doc.mss /dess/zmacs VIXEN; 
*Buffer-1* 



VIXEN: /dess/zmacs/* 
[1 line] 



(Fundamental) 
(Dired) 
(Text) 
(Fundamental) 



+ means new file or non-empty non-file buffer. * means modified file, 
= means read-only. 



Editing Buffers 



c-n-H Edit Buffers is not part of the standard comtab. It is 
similar to List Buffers (c-H c-B), except that the buffer listing 
that Edit Buffers produces is a buffer in its own right. (For an 
example showing how to make c-X c-B call Edit Buffers instead 
of List Buffers: See the section "Setting Editor Variables in Init 
Files", page 272.) It contains one line for each of the buffers in 
the editor. 



(c-n-X) Edit Buffers 

Displays a list of all buffers, allowing you to save or delete 
buffers and to select a new buffer. A set of single character 
subcommands lets you specify various operations for the buffers. 
For example, you can mark buffers to be deleted, saved, or not 
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modified. The buffer is read-only; like the Directory editor 
(Dired) buffer, you can move around in it by searching and with 
commands like c-N and c-P. 

The lines in the list are not mouse sensitive. With the cursor on 
the line for a buffer, the following single character commands 
apply to that buffer: 

With an argument of c-U, it prompts for a substring and then 
lists only buffers whose names contain that substring. 

RUBOUT Undeletes buffer above the cursor. 

SPACE Selects the specified buffer immediately. 

D Marks the buffer for deletion (K, c-D, c-K are 

synonyms). 

U Undeletes either the buffer on the current line or 

the buffer on the line above. 

S Marks the buffer for saving. 

Marks the buffer for setting not modified. 

X Executes an extended command (same as n-X). 



Showing a Buffer 

Use Show Buffer to just look at a buffer without editing it. 

c-X U Show Buffer 

Show Buffer (n-X) 

Prompts for the name of a buffer and prints out the buffer 
contents for viewing only in the typeout window. If there is more 
than one screenful, it pauses between screensful, displaying a 
—MORE— message at the bottom. 

SPACE, c-U, SCROLL Displays the next screenful. 

BACKSPACE, m-U Displays the previous screenful. 

RUBOUT Exits. 

An3rthing else exits and is executed as a command. 
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Inserting 
Command Output 
Into the Buffer 

You might want to save some output produced by a command into 
the buffer, rather than seeing it displayed on the typeout window 
and then erased. 

Execute Command 
Into Buffer 

Execute Command Into Buffer (n-X) 

Sends output from a command into the buffer. It prompts you for 
a command, either a key or an extended command. It inserts any 
typeout produced by the command into the buffer at point, rather 
than displaying it on the typeout window. Macro Expand 
Expression All (n-X) is a good example of a command whose 
output can be usefully saved in this manner. 

Hardcopying the Buffer 

Hardcopy Buffer (n-H) 

Prompts for the name of a buffer and then prints the specified 
buffer on the local hardcopy device. 

For full information on Genera hardcopying: See the section 
"How to Get Output to a Printer" in User's Guide to Symbolics 
Computers. 

Renaming the Buffer 

Rename Buffer (n-X) 

Prompts for a new name for the current buffer and changes the 
name accordingly. This operation removes any file association 
that the buffer had. 



Saving Buffers 



Save File Buffers (n-H) 

Offers to write out each buffer that is associated with a file. It 
prompts in the t3npeout window with the name of each buffer: 

Save file cheatin-heart.lisp >hwilliams> L: ? (Y or N) Yes. 

Save word abbrevs on file L:>hwilliams>jambalaya.qwabl? (Y or N) Yes, 

Save file rooty-tooty.text >hwiniams L: ? (Y or N) 
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Encrypting and 
Decrypting the Buffer 

Encrypt Buffer (n-«) 

Encrypts the contents of the buffer. It prompts for a key and 
does not echo it as you type it. It prompts for the same key 
again, just in case you mistyped it because of the lack of echoing, 
and makes sure you typed it the same both times. The encryption 
algorithm is the same one used by the Hermes mail-reading 
system. 

Decrypt Buffer (n-X) 

Decrypts the contents of an encrypted buffer. It prompts for a 
key and does not echo it as you type it. The encrjrption key given 
for decrjrpting must match the one used for encrypting. The 
encryption algorithm is the same one used by the Hermes mail- 
reading system. 

Reading a File 
Into a New Buffer 

Edit File (n-H) 

c-H c-F Find File 

Prompts for the name of a file and looks for a buffer currently 
associated with that file. If one is found, it selects it. Otherwise, 
it creates a new buffer and reads that file into it. 

When you read a file that has a Lisp file type into the buffer, if 
that file does not begin with an attribute line containing Base and 
S3Titax attributes, Zmacs warns that the file "has neither a Base 
nor a Sjoitax attribute" and announces that it will use the 
defaults. Base 10 and Zetalisp. See the section "Buffer and File 
Attributes in Zmacs", page 155. 

Reading a File 

Into an Existing Buffer 

The c-X c-U command. Visit File, is primarily useful when you 
type in a mistaken file name after c-X c-F and Zmacs responds 
(New File). You can simultaneously read in the correct file and 
get rid of the unwanted buffer with Visit File. 

c-X c-V Visit File 

Prompts for the name of a file and reads that file into the current 
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buffer. This action associates the current buffer with the 
specified file. 

This command can only be used if the current buffer is not 
already associated with an existing file. 

Writing the Buffer 
Contents to a File 

c-X c-U Write File 

Prompts for the name of a file and writes out the contents of the 
current buffer to the specified file. This changes the current 
buffer's name and associates it with the specified file. 
Subsequent saves using c-X c-S save to the newly specified file. 
This operation clears the modification flag. 

Saving the Buffer 
Contents to the File 

c-X c-S Save File 

Writes the contents of the current buffer out to the associated 
file and clears the modification flag. It does not write the file if 
the buffer is unchanged from when the file was last visited or 
saved. It reads a file name from the minibuffer if the current 
buffer does not have an associated file. 

Re-reading a File 
Into the Buffer 

Revert Buffer (n-X) 

Re-reads information into the buffer that it is associated with. 
For example, you can revert a Dired buffer to see the most 
current listing of that directory. You can also read in the most 
up-to-date version of a file. The command prompts for a buffer 
name, defaulting to the current buffer. The prompt serves as a 
confirmation, since Revert Buffer (n-X) throws away any 
modifications made to the buffer since you last saved or read the 
file or other information. This command is useful if you have 
damaged the buffer and want to start over or if the associated file 
is more current than the buffer. This operation clears the 
modification flag. 

Refind File (n-X) 

Re-reads a specified file into its associated buffer only if that file 
has changed on disk. The command prompts for a buffer name. 
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defaulting to the current buffer. If the associated file on disk has 
changed, it re-reads the file into the buffer. If the associated file 
on disk has not changed, it tells you that it is not necessary to 
refind that file. This command is useful when more than one 
person works on the same program. 

Refind All Files (n-X) 

Re-reads only those files that have changed on disk into their 
associated buffers, asking about each one. If the associated file 
on disk has not changed, the command tells you that it is not 
necessary to refind that file. This command is useful when more 
than one person works on the same program. 

With a numeric argument, Zmacs asks you for a string, which it 
matches with any part of the buffer names and operates only over 
buffers whose names contain that string. 

Creating a 
Fundamental 
Mode Buffer 

Find File In Fundamental Mode (n-X) 

Creates a fundamental mode buffer containing the file. This is 
useful because Zmacs does not parse the file while reading it in, 
thus the names of the functions in the file do not conflict with 
those already known to completion in n-. and similar commands. 
This command is necessary if the normal parsing of a Lisp Mode 
file signals an error, preventing it from being read into the editor 
to correct the cause of the error. 



Associating a File 
with a Buffer 

Set Visited File Name (n-X) 



Prompts for the name of a file and associates the current buffer 
with that file. This command does not read the specified file into 
the buffer. Effectively, the current contents of the buffer are 
declared to be the new intended contents of the specified file. 
This command should be used with caution to avoid 
unintentionally destro3dng the old contents of the specified file. 



Destroying Buffers 

c-X K 



Kill Buffer 
Prompts for the name of a buffer and destroys that buffer. If you 
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press END or RETURN instead of a name, c-K destroys the current 
buffer and prompts for the name of a buffer to select instead. 

Kill Some Buffers in->0 

For each existing buffer, tells you something about the status of 
the buffer and asks whether or not to delete it. If you elect to 
delete a buffer that has been modified since it was last saved, the 
command offers to save it first. 

Kill Or Save Buffers (n-X) 

Puts up a multiple-choice menu listing all existing buffers. 
Choices are: Save, Kill, Unmodify, and Hardcopy. Specify these 
options next to the buffer names in the menu. This command 
appears on the editor menu. 
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Appending a 
Region to a Buffer 

c-X R Append To Buffer 

Prompts for the name of a buffer and appends the contents of the 
region onto the end of the specified buffer. 

Appending a 
Region to a File 

Append To File (n-H) 

Prompts for the name of a file (Append region to end of file:) 
and appends the contents of the region onto the end of the 
specified file, writing a new version of that file. 

Prepending a 
Region to a File 

Prepend To File (n-«) 

Prompts for the name of a file and prepends the contents of the 
region onto the beginning of the specified file. 

Inserting a Buffer 
Into Another Buffer 

Insert Buffer (n-X) 

Prompts for the name of a buffer and inserts the entire contents 
of that buffer into the current buffer at the cursor. 

Inserting a File 
Into a Buffer 

Insert File (n-«) 

Prompts for the name of a file and inserts the contents of that 
file into the current buffer at the cursor. 
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Source Compare 

Source Compare (n-X) 



Example 



Compares two files or buffers, prompting for type (F or B) and 
name of each, and displays the results of the comparison in the 
t3npeout window. It saves the output in a support buffer named 
*Source-Compare-iV*. You can read the comparison while checking 
the file, for example, by going into two window mode with the 
comparison in one window and the file in the other. 



This example shows a comparison between the file new, as it was 
read into the buffer, and the buffer new, which contains the 
contents of the file new plus changes that have been made: 

Source compare made by ESG on 5/21/84 12:39:46 -*-Fundamental-*- 
of Buffer new /dass/pubs/pgs VIXEN: with File 
V I XEN : /dass/pubs/pgs/new 

****Buffer new /dass/pubs/pgs VIXEN:, Line #179 
Source Compare Merge compares two files or buffers, 
prompting for type and name, and merges the differences 

****File VIXEN: /dass/pubs/pgs/new. Line #179 
Compares two files or buffers, prompting for type and 
name, and merges the differences 



Done. 



^om-ce Compare Merge 

Source Compare Merge (n-X) 



Compares two files or buffers, prompting for type and name, and 
produces a new version that reconciles the differences between 
the two. You choose which version (if any) to accept. You can 
also manually edit one or both versions. 

At each place where the sources differ, the command prompts you 
twice. The first time you specify what to do to resolve the 
difference (prompts: Specify which version to keep:). (For 
example, you can keep one or the other version, both of them, or 
neither.) Respond to the prompt using these subcommands: 
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Option Action 

1 Leaves the first alternative in the text, redisplays 
the contents, and asks for confirmation of change. 

2 Leaves the second alternative in the text, redisplays 
the contents, and asks for confirmation of change. 

* Leaves both alternatives in the text, redisplays the 

contents, and asks for confirmation of change. 

I Leaves both alternatives in the text, along with the 

message lines from the source compare (*** MERGE 
LOSSAGE ***), but does not ask for confirmation. 

SPRCE Leaves both alternatives in the text, but does not 

redisplay the contents or ask for confirmation. 

! Disposes of this and all remaining differences the 

same way, without confirmation. It asks: What to 
do with remaining differences (1, 2, *, I, or 
RUBOUT? It uses whichever option you choose for the 
rest of the differences. 

c-R Exits from the prompt and allows you to edit. 

Press END to return to this question. 

RUBOUT Leaves nothing in the new buffer and does not 

redisplay the contents or ask for confirmation. 

The second time you confirm or reject the change that was made. 
The screen now shows the change that was made as a result of 
your choice and prompts: Please confirm .the change that has 
been made: (SPACE, RUBOUT, or c-R). Confirming it keeps that 
change and moves on to the next difference. Rejecting it returns 
to the prior appearance so that you can make a different choice: 

Option Action 

SPRCE Yes, that's right. 

RUBOUT No, take that back. 

c-R Exits from the prompt and allows you to edit. 

Press END to return to this question. 



When you finish confirming your decisions, Zmacs incorporates all 
changes into the new version in the specified buffer and the 
minibuffer displays: Done. Resectionizing the buffer. 
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Source Compare Merge also has a mouse interface. You can 
answer the first question by clicking left on the text you want to 
keep or on the dividing line between them to keep both. You can 
answer the second question by clicking left for "yes" (changes 
confirmed) or middle for "no" (changes rejected). 

Compare/Merge 
Commands for Definitions 

The compare/merge commands operate on definitions by 
comparing, or comparing and merging, the current version with 
the newest version, newest version on disk, or installed version. 

Comparing/Merging 
Current/Newest Versions 

Source Compare Newest Definition (n-X) 

Compares the current definition with the newest version in the 
normal source file for this definition, regardless of patch files. 
This command never looks in patch files; it only looks in original 
source files. If the definition was added by a patch (so that no 
original source file was recorded), the command cannot find the 
name of the source file. However, if you read the source file into 
the editor, it finds the definition in the editor buffer. You can 
use this command for comparing patch files and source files. 

Source Compare Merge Newest Definition (n-X) 

Compares and merges the current definition with the newest 
version in the normal source file. This command never looks in 
patch files; it only looks in original source files. If the definition 
was added by a patch (so that no original source file was 
recorded), the command cannot find the name of the source file. 
However, if you read the source file into the editor, it finds the 
definition in the editor buffer. You can use this command for 
comparing patch files and source files. 

Comparing/Merging 
Current/Saved Versions 

Source Compare Saved Definition (n-X) 

Compares the current definition with the source for the newest 
version on disk. 

Source Compare Merge Saved Definition (n-X) 
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Compares and merges the current definition with the source for 
the newest version on disk. 

Comparing/Merging 
Current/Installed Versions 

Source Compare Installed Definition (n-H) 

Compares the current definition with the source for the installed 
version. 

Source Compare Merge Installed Definition (n-X) 

Compares the current definition with the source for the installed 
version, merging the results. 
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Using Two 

Windows, Select Bottom 

c-X 2 Two Windows 

Shows two windows, selecting the bottom one. It splits the frame 
into two editor windows, selects the bottom one, and displays the 
next buffer from the global history in it. With a numeric 
argument, it displays that same buffer in the second window. 

Using Two 
Windows, Select Top 

c-X 3 View Two Windows 

Shows two windows, selecting the top one. It splits the frame 
into two editor windows, selects the top one, and displays the next 
buffer from the global history in it. With a numeric argument, it 
displays that same buffer in the second window. 

Creating Two 

Windows, 

Specifying Other Contents 

c-K 4 Modified Two Windows 

Selects a buffer, file, or definition in the other window. c-X 4 
combines the functions of splitting the frame and selecting 
contents for the second window. It prompts for the type of 
contents you want for the second window: Select what in other 
window? (B, F, D, or J), for buffer, file, definition, or jump to 
register. Then it reads the name of the file, buffer, definition, or 
register that you want to select for that window. 

Creating Two 
Windows with the 
Region in Top 

c-X 8 Two Windows Showing Region 

Makes two windows on the same buffer, with the top one 
displaying the current region. 

Changing Window Size 

c-X " Grow Window 

Changes the size of the current window by some number of lines. 
With a positive numeric argument, it expands the window; with a 
negative numeric argument, it shrinks the window. 
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Choosing the 
Other Window 

c-X Other Window 

Moves the cursor to the other window. 

Returning to One Window 

c-X 1 One Window 

Returns the editor frame to displaying only one window. It 
expands the current window to use the whole frame. With a 
numeric argument, it expands the other window to use the whole 
frame. 



Scrolling the 
Other Window 



c-n-V Scroll Other Window 

Scrolls the other window up several lines. By default, it scrolls 
the same way as c-U. With no argument, it scrolls a full screen. 
With just a minus sign as an argument (c-n- -U), it scrolls a 
full screen backward. A numeric argument tells it how many 
Hnes to scroll - a positive number scrolls forward, a negative 
number scrolls backward. 



Splitting the Screen 

Split Screen (n-X) 



Pops up a menu that offers to create a new buffer or find a file; 
makes several windows split among the buffers as specified. 
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Overview 



The commands described in this section are unlike most other 
Zmacs commands. Their main business is not manipulating 
buffers and their contents, but rather files out in a file system. 
First we discuss some commands for dealing with files, then we 
describe buffer and file attributes, and finally we explain Dired 
Mode, a special Zmacs mode for directory editing. 



Creating a Directory 

Create Directory in-X) 



Creates a new directory. It prompts for a directory name, using 
the standard conventions for defaults. For consistency between 
hierarchical and nonhierarchical file systems, you specify the 
directory to be created as the directory component of a pathname. 
That is, you must end the directory name with whatever delimiter 
or separator is appropriate for the host. 



Example 



Host Directory string Result 

TOPS-20 <A.B.C> Creates directory C 

Multics >udd>Sun>Luna>z> Creates directory z - 

Lisp Machine >sun>l una>b> Creates directory b 

UNIX /usr/jek/new/ Creates directory new 

Currently, the file servers for VAX/VMS and TOPS-20 can fail to 

create directories, due to missing options. 



Listing Files in a Directory 

List Files (n-X) 



Prompts for the name of a directory and displays the names of all 
the files in that directory. 

The file names are mouse sensitive. Pointing at a file name and 
clicking left is the same as doing a c-X c-F (Find File) on that 
file. Clicking right pops up a menu with three items: 

Load Loads the file into the Lisp world. The file must 

be either a Lisp source file or a compiled Lisp (6m) 
file. 

Find Reads the file into an editor buffer. 

Compare Compares the file with its most recent version and 

prints the differences. 
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Displaying the 
Contents of a Directory 

c-H c-D Display Directory 

Displays the directory of the file in the current Zmacs buffer. 
c-X c-D does not ask for a directory but lists files with the same 
host, device, directory, and name as the file in the current buffer. 
It lists files with any type and version. With a numeric 
argimient, it prompts for a directory to list and lists that 
directory. 

The heading of the directory hsting is mouse sensitive; clicking 
left on it selects a Dired buffer containing that directory listing. 

c-U c-X c-D does the same thing as List Files, except that it 
gives more details about each file. 



Show Directory 



Show Directory (n-H) 

Prompts for the name of a directory and and displays the 
directory contents for viewing only in the typeout window. If 
there is more than one screenful, it pauses between screensful 
displaying a —MORE— message at the bottom. 

SPACE Displays the next screenful. 

BflCKSPflCE Displays the previous screenful. 
RUBOUT Exits. 

An3^hing else exits and is executed as a command. 



Show Login Directory 

Show Login Directory (n-H) 



Displays the directory contents of the user's home directory for 
viewing only in the typeout window. If there is more than one 
screenful, it pauses between screensful displaying a — MORE— 
message at the bottom. 

SPACE Displays the next screenful. 

BACKSPACE Displays the previous screenful. 
RUBOUT Exits. 

An3rthing else exits and is executed as a command. 
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Showing a File 

Use Show File to look at a file without editing it. 

Show File (n-H) 

Prompts for the name of a file and displays the file contents for 
viewing only in the typeout window. If there is more than one 
screenful, it pauses between screensful, displa3dng a ~MORE~ 
message at the bottom. 

SPACE, c-U, SCROLL Displays the next screenful. 

BflCKSPRCE, n-V Displays the previous screenful. 

RUBGUT Exits. 

An3rthing else exits and is executed as a command. 

Showing the 
Properties of a File 

Show File Properties (n-X) 

Prompts for the name of a file and displays all the properties of 
the file that are maintained by the file system on which it 
resides. These are the properties such as creation date and time, 
author, time of last access, and length. For files on a Lisp 
Machine file system, it displays user-defined properties as well. 

It prompts for a file specification, which it merges with the 
current default to form the pathname. Wildcards are not 
accepted; this must correspond to a unique file or directory name. 

Changing the 
Properties of a File 

Change File Properties (n-H) 

Edits the properties of a file. Properties are the qualities of the 
file that are maintained by the file system on which it resides, 
such as creation date and time, author, time of last access, and 
length. For files on a Lisp Machine file system, this means user- 
defined properties as well. It prompts for the name of a file and 
pops up a choose-variable-values window, allowing you to alter 
various properties of the file. The exact properties that can be 
«it:ftred depend on the file system, but they might include: 
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• Generation (version) retention count 

• Author 

• Creation, modification, and reference dates 

• Protection flags 

• Other file-associated information 



Hardcopying a File 

Hardcopy File (n-X) 



Prompts for the name of a file and then prints the specified file 
on the local hardcopy device. 

For full information on Genera hardcopying: See the section 
"How to Get Output to a Printer" in User's Guide to Symbolics 
Computers. 



Renaming a File 

Rename File (r»-X) 



Renames one or more files. It prompts for the name of a file and 
then asks for a new name for that file. It renames the specified 
file with that new name. 

If the source file specification is wild, the target file specification 
must also be wild. 



Copjdng a File 
Into Another 



Copy File (n-X) 

Copies any type of file to another specified file. 

Prompts from the minibuffer for the names of two files and 
copies the contents of the first into the second. In file systems 
supporting multiple versions, this creates a new version of the 
second file whose contents are identical to those of the first. 

Copy File determines whether the source file is a character file or 
a binary file and copies the file appropriately. Different file 
systems sometimes use different character sets, and if the file is 
a character file, character translations have to be done (for 
example, on some hosts Return characters have to be converted 
into a carriage return and a hne feed). 

The numeric argument controls cop3dng of attributes and 
properties. With no numeric argument, it copies creation date 
and author and determines the mode (binary or character) of copy 
by the file being copied. To force mode, or suppress author or 



152 

Text Editing and Processing July 1 986 



File Manipulation Commands, cont'd 



creation date copying, supply a numeric argument created by 
adding the values corresponding to the descriptions below: 



Examples 



1 Force copy in 16-bit binary mode. 

2 Force copy in character (text) mode. 
4 Suppress copy of author. 

8 Suppress copy of creation date. 



For example, to suppress author and creation date for copying: 

c-12 Copy File (n-X) 

Use wildcard pathnames to specify groups of files for copying. 
For example, to copy all files in the subdirectory mine: 

F : >program>mi ne>« . * 

If the source file specification is wild, the target file specification 
must also be wild. 

you type: n-X Copy File 
Zmacs: Copy File from: 
you type: scrc:<lmfs>«.l*sp;9 

(Copies all the newest .LISP and .LSPs) 
Zmacs: to: 
you type: ff :>sys-hold>scrc-sources>old-*.*.* 
Zmacs: SCRC:<LMFS>TEST.LSP.3 is copied into 

f f : >sys-hol d>scrc-sources>ol d-test . 1 i sp . 3 

SCRC:<LMFS>FILES.LISP.147 is copied into 

f f : >sys-hol d>scrc-sources>ol d-f i 1 es . 1 i sp . 1 47 

Note that .LSP gets mapped into .lisp because Copy File uses 
canonical types when the type of the target pattern is :wild. 

This command can copy file authors and creation dates, when the 
target operating system supports setting these attributes. This 
action is not the default. 



Creating Links to Files 

Create Link (n-X) 



Creates a link to a file. It prompts in the minibuffer for the 
names of two files as arguments; first the name of the link, then 
the name of the target pointed to by the link. 
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Deleting Files 



Delete File (n-H) 

Deletes a file. It prompts in the minibuffer for a file name, 
which can be wild. With a wild name as an argument, deletes 
multiple files. It lists the files that would be deleted and requires 
that you confirm the list. It deletes the files, showing any errors 
that occur but continuing rather than halting. Displays a 
message in the minibuffer if the specified file does not exist. 



Deleting Multiple Versions 

Reap File (n-X) 



This command works in file systems supporting multiple versions. 
It prompts for the name of a file (not including version number) 
and deletes excess or temporary versions of the specified file, 
keeping the most recent n files. Any numeric argument specifies 
the number of versions to keep. With no numeric argument, the 
default keeps two versions and deletes any excess. It prompts for 
confirmation of files being deleted. 

Note: 

o To specify file types to be automatically marked for deletion, 
change the value of the variable zwei:* temp-file- type-list*, 
which contains a list of these files. Its default values are: 
"memo", "xgp", "@xgp", "unfasl", "output", "olrec" and 
"press". This variable also accepts the value ;anything, which 
can be any file type. 

• To alter the default number (2) of versions to be kept, change 
the value of the variable zwei: *file- versions-kept* to any 
ifixnxun. 

Clean Directory (n-X) 

Deletes excess versions or temporary file types in the specified 
directory. The default for excess versions is more than two. It 
prompts for confirmation of files being deleted. With a numeric 
argument n, it deletes excess versions greater than n. 

Excess is defined by the value of the Zmacs variable File Versions 
Kept or by the numeric argument. The temporary file types are 
defined by the Zmacs variable Temp File Type List. It accepts 
wildcards in the file name specification. (For descriptions of 
Zmacs variables: See the section "How to Specify Zmacs Variable 
Settings", page 269.) 



154 

Text Editing and Processing July 1 986 



File Manipulation Commands, contu 



155 

July 1986 Zmacs Manual 

Buffer and File Attributes 



Attributes 



Each buffer and generic pathname has attributes^ such as Package 
and Base, which can also be displayed in the text of the buffer or 
file as an attribute list. An attribute list must be the first 
nonblank line of a file, and it must set off the listing of attributes 
on each side with the characters -*-. If this line appears in a file, 
the attributes it specifies are bound to the values in the attribute 
Ust when you read or load the file. 

How They Work 

Suppose you want your new program to be part of a package 
named graphics that contains graphics programs. In this case, 
you want to set the Package attribute to graphics in three places: 
the generic pathname's property list; the buffer data structure; 
and the buffer text. Here are two ways to make the change: 

• If the package already exists in your Lisp environment, use Set 
Package (n-X) to set the package for the buffer. The command 
asks you whether or not to set the package for the file and 
attribute list as well. You can use this command to create a 
new package. 

• Use Update Attribute List (n-H) to transfer the current buffer 
attributes to the file and create a text attribute list. Edit the 
attribute list, changing the package. Use Reparse Attribute 
List (n-X) to transfer the attributes in the attribute list to the 
file and the buffer data structure. If the package you specify 
by editing the attribute list does not exist in your Lisp 
environment, Reparse Attribute List asks you whether or not to 
create it with default characteristics. 

Attribute- 
Manipulating Commands 

Update Attribute List (n-H) 

Updates the attribute list (-*- line) of the buffer. It creates or 
updates the attribute hst of the file, using the current set of 
parameters. A new attribute list inherits the default base (10) 
and the default syntax (Common-Lisp) plus the Package, Mode, 
Backspace, and Fonts attributes of the current buffer. It includes 
the Backspace and Fonts attributes in the line only if they have 
values other than the defaults. It does not change other 
attributes in an existing mode line. 
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Reparse Attribute List (n-H) 

Reparses the attribute list (-*- line) of the buffer. It finds the 
attribute list for the buffer and processes it to set up the 
environment that the line specifies. It changes the major mode, 
package, base, and so on, as necessary. When you edit the 
attribute list, you should then use this command to make the 
changes take effect in Zmacs. The changes take effect both for 
the editor buffer and for the file that the buffer is editing. 



Example 

Suppose the package for the current buffer is user and the base 
is 8. You want to create a package called graphics for the buffer 
and associated file. You also want to set the base to 10. If no 
attribute list exists, use Update Attribute List (n-H) to create one 
using the attributes of the current buffer. An attribute list 
appears as the first Hne of the buffer: 

;;; -*- Mode: LISP; Package: USER; Base: 8 -*- 

Now edit the buffer attribute list to change the package name 
from USER to GRAPHICS and to change the base from 8 to 10. Use 
Reparse Attribute List (n-X). The command queries: 

The file belongs in package GRAPHICS, which does not exist. 
Create it with default characteristics, 
Try again, or Use another package? (C, T, or U) 

Answer C to create the new package. The package becomes 
graphics and the base 10 for the buffer and the file. 

File Attribute Checking 

Zmacs notes errors in file attribute Usts and warns you when it 
finds an unknown attribute. It goes ahead and ignores the 
unknown attribute in the list. The purpose of the warning is 
simply to help you detect misspellings. 

Setting the Package 

Set Package (n-X) 

Changes the package associated with the buffer. It prompts for a 
new package, offering to create the package if necessary. Forms 
that are read from the buffer are read in that package. (The 
default value for this attribute is user.) 

You can have any package as the default package by specifying it 
as the value of the Zmacs variable Default Package. (For 
descriptions of Zmacs variables: See the section "How to Specify 
Zmacs Variable Settings", page 269.) You can set the variable in 
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your init file by using the internal form of its name. (See the 
section "Creating an Init File", page 272.) 

For example, in your init file: 

(login-forms 

(setf zwei :*default-package* (pkg-find-package "tv"))) 

If you set the variable to nil, it sets the default to the package 
from the previous buffer. 

Information about the package attribute exists in four places. Set 
Package offers to set the package for the generic pathname 
attribute list and updaTes the attribute line in the buffer when 
you answer Yes to: 

Set it for the file and attribute list too? 

Your answer affects the various versions of the package attribute 
as follows: 



Location 


wy" 


"N" 


Generic pathname 


changes 


same 


Buffer property 


changes 


changes 


Buffer text 


changes 


same 


Current package 


changes 


changes 



The system is informed that the file belongs to the specified 
package. If you are not sure what to answer, say Yes. The 
global variable zwei:*set-attribute-updates-list* controls this 
query. Its default value is ;ask. Setting the variable to t means 
Yes; nil means No. 

Base and Syntax Defaults 

The default value of zhbase and zhibase is 10. If you have been 
writing code that has a Base attribute in the mode line, you 
should not experience any difficulties. However, in order to help 
avoid problems in general, changes have also been made to the 
editor and compiler: 

• In the mode line (the -*- line in Lisp source files) are the Base 
and S3nitax attributes. The base can be either 8 or 10 (default). 
The syntax of a program can be either Zetalisp or Common- 
Lisp. 

• If there is a Base attribute, but no Syntax attribute, the syntax 
defaults to Common-Lisp. 
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• If there is a Syntax attribute of Common-Lisp, and no Base 
attribute, the base is assumed to be 10. 

« If there is neither a Base nor a Syntax attribute. Base is 
assumed to be the default base (10) and the syntax is assumed 
to be Common-Lisp. Furthermore, a warning is issued to the 
effect that there is neither a S3mtax nor a Base attribute. You 
should edit your program accordingly. With most programs, the 
Zmacs command Update Attribute List (n-X) will add the 
appropriate attributes to the mode line, following the above 
defaults. 



Setting the Syntax 
for Symbolics 
Common Lisp 



If you use the new Symbolics Common Lisp (SCL), you must 
explicitly set the syntax in the file attribute line (formerly, 
Zetalisp was the implicit default). For more information about 
SCL: See the section "Introduction to Sjonbolics Common Lisp" 
in Symbolics Common Lisp. 

The file attribute line of a Common Lisp file should be used to 
tell the editor, the compiler, and other programs that the file 
contains a Common Lisp program. The following file attributes 
are relevant: 

Syntax The value of this attribute can be Common-Lisp 

or Zetalisp. It controls the binding of the 
Zetalisp variable zhreadtable, which is known 
as *readtable* in Common Lisp. The default 
sjntax is Common-Lisp. 

Package user is the package most commonly used for 

Common Lisp programs. You can also create 
your own package. Note that the Package file 
attribute accepts relative package names, which 
means that you can specify user rather than cl- 
user. 

The following example shows the attributes that should be in an 
SCL file's attribute line: 

;;; -*- Mode:Lisp; Syntax: Common-Lisp; Pacl<age:USER -*- 
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Set Lisp Syntax (n-H) 

Changes the buffer into Common-Lisp syntax or Zetalisp syntax. 
It asks whether to update the attribute list (-*- line) of the buffer. 
If you answer yes, it creates or updates the attribute list of the 
file, using the current set of parameters, if any. It does not 
change other attributes in an existing mode line. 

Other Set 
Commands for File 
and Buffer Attributes 

Each of the file attributes has a Set command associated with it. 
You have two choices when you want to change an attribute for a 
file: 

o Edit the text of the buffer and then use Reparse Attribute List. 

• Use the relevant Set command and answer Y to its query. The 
meanings for Y and N are the same as for the Set Package 
command (except that only the Set Package command affects 
the current package). 



Update Attribute 
List Query 



The Set commands use the value of the global variable 
zwei:*set-attribute-updates-list* to determine whether to query 
you about updating the file attribute list. The default value for 
the variable is :ask; set to nil to suppress the query. 

Value Meaning 

:ask Always asks whether to update the attribute list. 

nil Never updates the attribute list. 

t Always updates the attribute list. 



Set attribute (n-X) 

where attribute is one of the following: Backspace, Base, Fonts, 
Key, Lowercase, Nofill, Package, Patch File, Syntax, Tab Width, 
Variable, or Vsp. It sets attribute for the current buffer. It 
queries whether or not to set attribute for the file and in the text 
attribute list. 

Attribute Descriptions 

The following table describes some of the attributes, their 
associated Set commands, and the default value for the attribute. 
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Backspace The Set Backspace command (default value nil) 

controls whether a backspace character in a file 
displays as the word "back-space" with a 
lozenge around it or performs the backspace. 
The default is the lozenge form. 

Base The Set Base command (default value 10) 

specifies the value of zlribase that the Lisp 
reader uses when reading forms from the file. 
Thus, Base controls the zhibase used when you 
evaluate or compile parts of the buffer, and 
controls the value of zhbase for printing during 
evaluating all or part of the buffer. This value 
does not affect the values of either zhbase or 
zhibase in the Lisp Listener you get by using 
SUSPEND. 

Fonts The Set Fonts command (default value nil) 

changes the set of fonts to use. It reads a 
sequence of font names separated by spaces, 
commas, or both from the minibuffer. 

Lowercase The Set Lowercase command (default value nil) 

means that the file being edited is intended to 
contain lowercase code or text. When the 
Lowercase attribute is nil (that is, not present), 
whatever case handling you specify prevails. 
To automatically uppercase code, use the 
following in your init file: 

((login-forms 

(setf zwei : 1 i sp-mode-hook 
' zwei : el ectri c-shi f t-1 ock-i f-appropri ate) ) 



(See the section "Creating an Init File", page 
272.) When the Lowercase attribute is 
anything but nil (you answer Y to its query), 
the Electric Shift Lock Mode is never turned on 
automatically. 
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NofiU 



The Set NofiU command has a default value of 
nil, which means that whatever autofilling 
behavior you specify prevails. When NofiU is 
anything else (you answer Y to its query), it 
means that autofilling is not appropriate for 
people who specify the mode of "autofilling if 
appropriate". 

Use Nofill sparingly. Setting it means that 
everyone who edits the file has to be satisfied 
with Auto Fill Mode being off by default. In 
most cases, it is more reasonable to let an 
individual user's preferences prevail. It is 
useful for files that are not plain text, such as 
mailing lists, where you need to avoid spurious 
Hne breaks. 

To have autofilling turned on by default, use 
the following in your init file (See the section 
"Creating an Init File", page 272.): 

(login-forms 

(setf zwei :text-inode-hook 
' zwei : auto-f i 1 1 -i f-appropri ate) ) 

People who do not want it never get it by 
default. 



Patch-File 



Tab-Width 



The Set Patch File command has a default 
value of nil, which means that the file does not 
contain patches. When a file is classified as 
containing patches (you answer Y to its query), 
fdefine does not warn about functions being 
redefined during loading. Classifying something 
as a patch file also affects Edit Definition 
(which prefers files that are not patches) and 
defvar (which becomes zltsetf). 

The Set Tab Width command (default 8 
characters) specifies how many spaces the 
editor uses between "tab stops". 
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Vsp The Set Vsp command (default 2 pixels) 

specifies the vertical spacing (in pixels) between 
the text lines of an editor window. It specifies 
the distance between the descenders of one line 
and the ascenders of the next. 
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Overview 



There is a special Zmacs mode, called Dired, just for doing 
housekeeping in a directory. In this mode, you see the names of 
all the files in a directory at once, and can manipulate these files 
in various ways. 



Entering Dired 

The following commands specify a directory to manipulate and 
enter Dired mode. 

Dired (n-X) 

Edit Directory (n-H) 

Prompts for a wildcard file specification for files contained in the 
specified directory. The default edits all files in the current 
directory by specifying wild name, type, and version. You must 
type the pathname in the form acceptable to your host system. 

c-H D Dired 

Edits the files in the directory that contains the current file. 

With a numeric argument of 1, shows files with the same host, 
device, directory, and name as the file in the current buffer. It 
lists files with any type and version. 

With a c-U argument, it prompts for a wildcard file specification 
showing the name of a directory to edit. 

The Dired. Display 

When you go into Dired mode, Zmacs creates a special buffer that 
contains the names of the files that are under consideration, as 
well as some auxiliary information pertaining to those files. In a 
t3^ical Dired buffer, each line describes a single file and lists the 
following information, from left to right: 

• An indicator (D) that shows if the file has been marked for 
deletion or is already deleted 

o The physical volume of the file (on some hosts) 

• The name of the file 

« The length of the file in blocks (where the length of a block is 
system-dependent) 

• The length of the file in bytes, followed by the b3^e length in 
bits, enclosed in parentheses 

o ! if the file has not been backed up to tape 
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• $ if the file has been marked against reaping 

• (2) if the file has been marked against deletion 

• The file's creation date 

• The file's creation time 

• The date the file was last referenced, enclosed in parentheses 

• The author of the file 

• Optionally, the name of the last user to read the file 

If there are too many files to be displayed in one screenful, the 
Zmacs window looks only at one section of the directory at a time 
(although the buffer does contain the names of all the files). 

The files are arranged in alphabetical order by name. 

Updating the Display 

Use the Revert Buffer (n-X) command to update a Dired display. 
(See the section "Re-reading a File Into the Buffer", page 138.) 
After using Dired commands (or native host commands) to 
perform operations on files in your directory, invoke Revert 
Buffer, which reexecutes Dired with the default directory name 
and re-reads the updated directory into the buffer. 

Dired Commands 

Dired mode has its own command table (comtab) for manipulating 
the files whose names are displayed. These commands are 
described in this section. All invocations given in this section are 
with respect to the Dired comtab and do not apply to regular 
Zmacs. 

You use Dired by moving the cursor around to various lines and 
then specifying operations to be performed on the file listed on 
that line (the current file, while in Dired Mode). 

Most Dired commands schedule some action for the future rather 
than performing it instantly. For example, when you want to 
delete a file using Dired, you move the cursor to the line 
describing that file and type D. Rather than deleting the file 
immediately, Dired marks the file for deletion. The deletion 
actually happens when you leave Dired mode and confirm your 
request. (See the section "Getting Out of Dired", page 166.) 

Some of the commands in Dired mode take numeric arguments. 
You type numeric arguments in exactly the same way as you do in 
Zmacs proper, except that you do not have to hold a modifier key 
down while t3T)ing the argument - just typing the number 
suffices. 
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Command Summary 

The following table summarizes the Dired commands: 



Character 

RUBOUT 

SPACE 



G 
nH 

L 
nt\ 



Action 

Undeletes file above the cursor. 

Moves to the next file. 

Moves to the next file that is not backed up. 

Complements the Don't Reap ($) flag. 

Describes the attribute list of this file. In text 
files, this is the -*- line of the file. In compiled 
Lisp files, it includes information about the 
compilation as well. 

Changes properties of current file. 

Complements the Don't Delete (@) flag. 

Compares this file with the newest version (Source 
Compare). 

Queues this file for function application. 

Copies this file to someplace else. 

Marks the file for deletion (K, c-D, c-K are 
synonyms). 

Edits the file in a buffer, or runs Dired if the line 
is a subdirectory name. 

Sets and enforces the generation retention count. 

Marks excess versions of the file for deletion 
(argument means whole directory). 

Loads the file into Lisp. 

Moves to the next file with more than n versions 
(see the Zmacs variable File Versions Kept). (For 
descriptions of Zmacs variables: See the section 
"How to Specify Zmacs Variable Settings", page 
269.) 

Prints the file on the standard hardcopy device. 
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Q Exits. It shows the files marked for deletion and 

prompts for confirmation. The exit display marks 
files that have special status, using the following 
marks: 

: a link 

> most recent version 

$ file marked for not reaping 

! file not backed up 

R Renames this file to something else. 

U Undeletes either the file on the current line or the 

file on the line above. 

U Views the file without creating a buffer (using 

View File conventions). 

H Executes an extended command (same as n-H). 



Default Pathnames 
in Dired 

When the current buffer is a Dired buffer, and you execute an 
editor command that accepts a file name as an argument, the 
default file name is the file name that appears on the line of the 
Dired buffer that point is on. 

This makes it easier to do things to the file that you are 
currently operating on in Dired. For example, you can move point 
to some line, do Compile File (n-X), and the command defaults to 
that file name. 



Getting Out of Dired 

Q 
END 



Dired Exit 



Leaves Dired mode. It prints the names of files marked for 
various actions and gets your final confirmation that these actions 
are really to be performed. 

At this point the available options are: 

Y Delete but do not expunge, also doing any other 

marked actions. 

N Go back to Dired. 
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Q or H Abort out of Dired. 

E Delete files and expunge directory. This is meaningful 

for file systems in which there is undeletion, such as 
TOPS-20, TENEX, and the Lisp Machine file system. 
This command is useful if you use Dired to free up 
disk space, since the disk space is not deallocated until 
the directory is expunged. 

Dired Exit performs those actions and returns to the previous 
buffer. 

RBORT Dired Abort 

Leaves Dired mode at once, without performing any actions on 
marked files. You can also just switch to another buffer. 

Online 

Documentation for Dired 

If you do not have a manual and cannot remember what the 
commands do, just press HELP. 

? Dired Help 

HELP 

Displays a short table explaining the Dired commands. 



Dired Menu 



Click right in Dired to display the Dired menu, which offers to 
perform the following actions on the listing: 

Sort by reference date (up) 
Sort by reference date (down) 
Sort by creation date (up) 
Sort by creation date (down) 
Sort by file name (up) 
Sort by file name (down) 
Sort by file size (up) 
Sort by file size (down) 
Dired Automatic 
Dired Automatic All 
Dired Change File Properties 
Dired Describe Attribute List 

See the section "Deleting Multiple File Versions in Dired", page 
170. See the section "Changing File Properties in Dired", page 
168. See the section "Viewing File Attributes in Dired", page 168. 
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Loading a File in Dired 

L Load File 

Loads the current file. It displays a message Loading the 
file. . . in a t3rpeout window and finishes with the message 
Loading done. 

Moving Around in Dired 

SPnCE Down Real Line 

c-N 

Moves point to the next line (same as in regular Zmacs). With a 
numeric argument of n, it moves point forward n lines. 

c-P Up Real Line 

Moves point to the previous line (same as in regular Zmacs). 
With a numeric argument of n, it moves point backward n lines. 

Viewing File 
Attributes in Dired 

, Dired Describe Attribute List 

This command is also available on the pop-up menu that you get 
when you click right in Dired. It prints out the contents of the 
attribute list of the current file (the one where point is). It 
works for character files and compiled files. 

Changing File 
Properties in Dired 

Dired Change File Properties 

This command is also available on the pop-up menu that you get 
when you click right in Dired. It edits the properties of the 
current file. These properties are the qualities of the file that are 
maintained by the file system on which it resides, such as 
creation date and time, author, time of last access, and length. 
For files on a Lisp Machine file system, this means user-defined 
properties as well. It pops up a choose-variable-values window, 
allowing you to alter various properties of the file. The exact 
properties that can be varied depend on the file system, but they 
might include: 

• Generation (version) retention count 

• Author 
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o Creation, modification, and reference dates 

o Protection flags 

• Other file-associated information 

Viewing and 
Editing File 
Contents in Dired 

You might want to look at the contents of a file before deciding 
what to do with it. You might also want to read the file into a 
buffer and edit it. 

U Dired View File 

Displays the contents of the current file on the typeout window. 

Use this command when you just want to skim the contents of 
the file, not edit it. You can move forward while viewing with 
SPRCE, c-U, or SCROLL and move backward with BRCKSPnCE or n-U. 

E Dired Edit File 

Reads the current file into a Zmacs buffer and selects that buffer. 
You are then back in normal Zmacs and can edit the file 
normally. When you want to return to Dired mode, just use the 
c-n-L command to reselect the Dired buffer. 

Comparing Recent 
Versions of Files 
in Dired 

Often before deciding whether or not to delete a file, you want to 
find out exactly how extensive the differences are between the file 
and its most current version. 

= Dired Srccom 

Compares the current file with its most recent version and 
displays the differences on the t3^eout window. With an 
argument of c-U, it asks what version to compare it to. 

Copying and 
Renaming Files 

C Dired Copy File 

Copies the current file. It prompts for the new pathname, 
displaying the default pathname. 
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R Dired Rename File 

Renames the current file. It prompts for the new pathname, 
displa3dng the default pathname. 

Marking Files for Deletion 

D Dired Delete 

K 

c-D 

c-K 

Marks the current file for deletion. Dired puts a D in the first 
column to show that the file has been so marked. 

With a numeric argument of /i, it marks the next n files for 
deletion. 

Sometimes you mark a file for deletion by mistake. Here is how 
you recover from this error: 

U Dired Undelete 

U takes one of two actions: 

1. If the current file is marked for deletion, printing, or a 
fimction application (with a D, P, or A), reprieves it. 

2. In file systems with soft deletion, U marks a deleted file for 
undeletion. 

In either case, U removes the D, P, or A next to the file. If the 
current file is not marked with D, P, or A, U reprieves the file on 
the immediately preceding line, positioning point on that line. 

With a numeric argument of n, it reprieves the files on the next 
71 lines including the current line. 

RUBOUT Dired Reverse Undelete 

Reprieves the file on the preceding line. 

With a numeric argument of /i, it reprieves the files on the 
previous n lines including the current line. 

Deleting Multiple Versions 

If you are using Dired for housekeeping purposes, the following 
commands are useful: 
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N Dired Next Hog 

Moves point to the next file with superfluous versions. 
Superfluous is defined by the value of the Zmacs variable File 
Versions Kept (whose default is 2) or by a numeric argument. 
(For descriptions of Zmacs variables: See the section "How to 
Specify Zmacs Variable Settings", page 269.) 

H Dired Automatic 

This command is also available on the pop-up menu that you get 
when you click right in Dired. It marks all the superfluous 
versions of the current file for deletion. With an argument of 
c-U, it marks superfluous versions of all files in the Dired buffer. 

Setting Generation 
Retention Count 

G Dired Set Generation Retention Count 

Sets and enforces the generation retention count on this group of 
files, which specifies how many versions to save (that is, deletes 
multiple versions). 

With a numeric argument n, sets it to ti versions. With no 
numeric argument, prompts for a number in the minibuffer. An 
argument of zero means save all versions. Enforce means mark 
for deletion or undeletion. 

Protecting Files 
From Being Reaped 

In addition to keeping other users aware of protected files, 
protection features can also inform the system itself. Some file 
systems have automatic reaping facilities that go into action when 
storage becomes scarce. Most such systems have a don't reap bit 
associated with each file; use it to protect only your most vital 
files. 

$ Dired Complement No Reap Flag 

Complements the Don't Reap flag associated with the current file; 
Dired displays the flag as $ between the length and date on that 
line. With a numeric argument of n, it complements the flag on 
the next n files, including the current one. 

Protecting Files 
From Being Deleted 

@ Dired Complement Dont Delete Flag 
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Complements the Don't Delete flag associated with the current 
file; Dired displays the flag as @ between the length and date on 
that line. 

With a numeric argument of /i, it complements the flag on the 
next n files, including the current one. 

Finding Files That 
Have Not Been 
Backed up 

Many file systems have tape backup facilities so that files can be 
copied onto tape against the possibility of a file system disaster. 
These systems almost always associate a bit with each file that is 
set when the file is created or modified and cleared when it is 
backed up to tape. 

! Dired Next Undumped 

Moves point forward to the next file that has not yet been backed 
up; Dired displays the flag as ! between the length and date on 
that line. 

Marking Files to 
Be Hardcopied 

You might want to obtain a hardcopy of a group of related files. 
Dired allows you to mark files to be hardcopied as well as to be 
deleted. 

P Dired Hardcopy File 

Marks the current file for printing. Dired puts a P in the first 
column to show that the file has been so marked. 

With a numeric argument ti, marks the next n files for printing. 

Applying Arbitrary 
Functions to Files 

Very occasionally, you want to perform some operation on selected 
files in your directory for which there is no Dired command 
provided. When this occurs, you can write up the operation that 
you want to perform as a Lisp function, whose single argument is 
the pathname of the file. The following command is relevant: 

fl Dired Apply Function 

Marks the current file for having an arbitrary function applied to 
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it. Dired puts a A in the first column to show that the file has 
been so marked. With a numeric argument of n, it marks the 
next n files, including the current one. 
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Major Editing Modes 



Overview 

Whenever you are editing some text, some set of modes is in 
effect. The buffer is always associated with one major mode that 
tells the editor what kind of document is being edited. A major 
mode has the following characteristics: 

• It has its own distinct set of key bindings. 

• It affects groups of related language-specific items, such as 
delimiter characters and indentation rules. 

The major modes are listed below. You can establish the mode: 

• By turning it on using the prefix n-X followed by the name of 
the mode. For example, to invoke Lisp Mode, type: n-X Lisp 
Mode. 

• By setting it in the attribute list. See the section "Buffer and 
File Attributes in Zmacs", page 155. 

• By having Zmacs do it for you when you specify a file with c-X 
c-F or the Edit File command. It recognizes the type 
component of the pathname of the file (for example, folon.lisp) 
and puts the buffer in the corresponding mode. 

Fundamental Mode 

Fundamental Mode enters Zwei's fundamental mode (the default 
mode). 



Lisp Mode 



Text Mode 



Lisp Mode sets things up for editing Lisp code. It puts Indent- 
For-Lisp on TRB. 

When you read a file that has a Lisp file type into the buffer, if 
that file does not begin with an attribute line containing Base and 
Syntax attributes, Zmacs warns that the file "has neither a Base 
nor a Syntax attribute" and announces that it will use the 
defaults, Base 10 and Zetalisp. See the section "Buffer and File 
Attributes in Zmacs", page 155. 



Sets things up for editing English text. It puts Tab-To-Tab-Stop 
on TRB. 
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Note 



Zmacs supports Fortran Mode as a part of FORTRAN 77, the 
separately priced software product. For more information, see the 
User's Guide to the FORTRAN 77 Tool Kit. 



Macsyma Mode 



Macsyma Mode enters a mode for editing Macsjmia code. It 
modifies the delimiter dispatch tables appropriately for Macsyma 
syntax, makes comment delimiters /* and */. It puts Indent- 
Relative on TAB. 



Midas Mode 



Bolio Mode 



Teco Mode 



PU Mode 



Midas Mode sets things up for editing PDP-10 assembly language 
code. 



Bolio Mode sets things up for editing Bolio source files. It is like 
Text Mode, but also makes c-n-N, c-n-:, and c-n-* insert font 
characters, and makes word-abbrevs for znil and zt. 



Teco Mode sets things up for editing TECO. It makes comment 
delimiters be !* and *!. It puts Indent-Nested on TRB, Forward- 
Teco-Conditional on n-', and Backward-Teco-Conditional on n-]. 



Pll Mode sets things up for editing PL/1 programs. It makes 
comment delimiters /* and */, and puts Indent-For-PU on TRB, 
RoU-Back-PU-Indentation on c-n-H, and Plldcl on c-=. 
Underscore is made alphabetic for word commands. 



Electric Pll Mode 

Electric Pll Mode sets things up for editing PL/1 programs. It 
does ever3rthing Pll Mode does: it makes comment delimiters /* 
and */, puts Indent-for-PU on TAB, RoU-Back-PU-Indentation on 
c-n-H, , and Plldcl on c-=. Underscore is made alphabetic for 
word commands. In addition, ; is PU-Electric-Semicolon, : is PU- 
Electric-Colon, tt is Rubout, @ is Clear, s is Quoted Insert. 
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Using the Zmacs Speller 



The Zmacs Speller is a small, simple set of tools to help you spell 
words right. The Speller can examine a single word, a Zmacs 
region or buffer, a file, or a group of files, for spelling errors. 
When it encoimters a word not listed in one of its dictionary files, 
it alerts you with a message and a menu of possible responses. A 
large dictionary of common words is included as part of the 
Zmacs editor. You can add other dictionaries of special spellings, 
as used by individuals or groups of users on your system, to the 
Ust. 

The quickest way to see what the Speller can do is to go to a 
Zmacs text buffer, type an incorrectly spelled or nonexistent word, 
and then press n-$. Say you type "gorax". When you press n-$, 
you see in the minibuffer at the bottom of the screen: 

"gorax" is unknown and possibly misspelled. 

A menu appears offering you a choice of Prompt and Accept and 
the word "borax", which is the only word in the basic dictionary 
close to the spelling of "gorax". The menu may also contain the 
names of one or more dictionaries. 

If you meant to type "borax", click on the word on the menu and 
the spelling is changed. 

If you want to accept the spelling "gorax", click on Accept or 
move the mouse cursor off the menu. 

If you want some entirely different word, click on Prompt and 
you are prompted to type another word. If that word is spelled 
correctly, the message 

Correcting "gorax" to "monkey". 

appears in the minibuffer. If the word is spelled incorrectly, the 
change is made anyway, and the following messages 

Warning: "shimbax" is not in the dictionary. 
Correcting "gorax" to "shimbax". 

appear in the minibuffer. 

If you click on a dictionary name, the spelling is added to that 
dictionary for the rest of the session. You can also add the new 
words permanently to a dictionary by saving the dictionary to a 
file. See the section "n-X Save Spell Dictionary", page 191. See 
the section "n-K Save All Spell Dictionaries", page 192. 

Once you've tested the n-$ command, read a file into the buffer. 
Enter the command n-X Spell Buffer and watch what happens. 
Chances are there is a misspelled word in the buffer, or at least a 



1£l 

July 1986 Zmacs Manual 



Using the Zmacs Speller, contu 



word that is not in the dictionary. The menu produced by this 
command has an additional entry, Accept once. Click on Accept 
once if you want the Speller to flag the word the next time it 
appears. Click on Accept if you want the Speller to ignore the 
word for the duration of the spelling check. 

NOTE 

To the Speller, any word not in the dictionaries is 
misspelled by definition. Not all words or alternate 
spellings are in the basic dictionary. 

Also, for purposes of the Speller, a word in running text 
is defined to be a sequence of characters, each of which 
must be a letter or an apostrophe. The apostrophe is 
allowed so that contractions and possessives are 
recognized as words. This definition of a "word" is not 
exactly the same as that used by the Zwei "word" 
commands (m-F and so forth). 



The Zmacs Speller Menu 

When the Speller encounters a word not in the dictionary in the 
course of a n-$, n-H Spell Buffer, Spell Region, or Spell Word 
command, a warning appears in the minibuffer 

"rugnue" is unknown and possibly misspelled. 

and a menu gives you a series of actions to choose from. 

Prompt Prompts in the minibuffer for a 

replacement word. The misspelled 
word is replaced by the new word. 
The replacement word is also checked 
against the dictionaries and you are 
warned if it isn't found. Any 
uppercase letters you type are 
included when the word is replaced. 
If the questioned word had an initial 
capital letter, so will the replacement. 
Any other capital letters in the 
original word are ignored. 

While the menu is showing, pressing 
c-P is the same as clicking on 
Prompt. 
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Accept once 



Accept 



DICTIONARY-NAME 



suggestion 



Accepts this spelling just this once. 
That is, the Speller ignores the 
spelling this time, but if the same 
misspelling is encountered again, it 
challenges the spelling again. 
Moving the mouse cursor off the 
menu is the same as clicking on 
Accept once. 

While the menu is showing, pressing 
c-0 is the same as clicking on 
Accept once. 

Accepts this spelling and considers it 
a correct spelling for the duration of 
the command. There is no way to 
save words permanently using 
Accept. To save words permanently, 
you must accept them by clicking on 
a dictionary name. 

While the menu is showing, pressing 
c-R is the same as clicking on 
Accept. 

Accepts the spelling and adds it to 
the dictionary for the remainder of 
the boot session. You can also add 
the spelling to the dictionary file 
permanently. To add a dictionary to 
the list, use the n-X Read Spell 
Dictionary command. 

See the section "n-X Read Spell 
Dictionary", page 190. 

See the section "n-X Save Spell 
Dictionary", page 191. 

See the section "n-X Save All Spell 
Dictionaries", page 192. 

Whenever possible, the Speller 
suggests words that are close in 
spelling to the questioned word. One 
or more suggestions may appear on 
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the menu. If one of the suggestions 
is what you intended, click on it and 
the spelling in the text is changed to 
the suggested spelling. 
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The Zmacs Speller allows you to check spelling by word, region, 
buffer, file, or groups of files (including tag tables). 



n-$ (Spell This Word) 



Checks the spelling of the current 
word. If point is just to the right of 
a word, that word is checked. This 
means you can type a word and then 
press n-$ to check the spelling. If 
point is on a word, that word is 
checked. 

Use this command to check the 
spelling of individual words in your 
current buffer. 



n-x Spell Word 



n-K Spell Word 



Prompts for a word and runs a 
spelling check on it. If the word is 
spelled according to the dictionaries, 
you are informed in the mini-buffer. 
If the word is not spelled according 
to the dictionaries, you are informed. 
If the dictionaries contain any words 
similar to your misspelling, they are 
listed also. 

Use this command to check the 
spelling of words before you type 
them in your buffer. 



n-x Spell Region 



n-X Spell Region 



Rims a spelling check on the current 
region. 

Use this command to check spelling 
in a region you have marked. 
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n-x Spell Buffer 



n-X Spell Buffer 



Runs a spelling check on the entire 
current buffer. It does not matter 
where point is when you issue the 
command. The entire buffer is 
checked. 



n-x Spell File 



n-x Spell File 



Runs a batch-mode spelling check 
over a file. With wildcards, you can 
also specify a group of files. 

This command prompts for a 
pathname and also for the name of a 
buffer where the words not in the 
dictionaries are to be written. The 
questioned words are written to a 
buffer in alphabetical order, but 
without identification as to the file 
they came from. You can save this 
buffer if you wish. 

See the section "n-X Tags Spell", 
page 185. 



n-x Tags Spell 



n-x Tags Spell 



Runs a batch-mode spelling check on 
all the buffers of the current tags 
table and finds all of the words that 
aren't in any of the dictionaries and 
writes them (in alphabetical order) 
into a buffer you specify. You can 
save this buffer if you wish. 

See the section "n-X Spell File", page 
185. 
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See the section "Introduction to Tag 
Tables and Search Domains", page 
122. 
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Introduction to 
Speller Dictionaries 

The Zmacs Speller considers a word to be spelled correctly if it is 
in a dictionary file and to be misspelled if it is not in a dictionary 
file. The Speller always checks against the basic dictionary 
provided as part of Zmacs. In addition, the Speller checks against 
one or more optional site-specific dictionaries and one or more 
user-specific dictionaries. 

Here are some basic definitions of dictionary terms: 

o A dictionary is an object in the Lisp environment containing a 
set of words. It has an associated pathname, and a 
modified-p flag. The pathname refers to a dictionary file. The 
modified-p flag indicates whether words have been added to the 
dictionary since it was read in. If the modified-p flag is on, 
the n-X Save Spell Dictionary and n-H Save All Spell 
Dictionaries commands saves the dictionary. When a dictionary 
is saved, the modified-p flag is turned off. 

o A dictionary file is a file that holds a set of words. It can be a 
binary (compiled) dictionary or a character (text) dictionary. 

° A binary dictionary is compiled and has the canonical file 
type "diet" ("dc" on Unix, "dct" on VMS). The binary 
dictionary is fast to load or dump. 
° A character dictionary can be any file with text in it. There 
is no naming restriction, but it is clearer to use the file type 
"text". The words in the file are the words of the dictionary 
set, minus duplicates. This format can be easily created, 
examined and modified by editing, 
o There is a special list of dictionaries used by the Zwei 
commands. This is the dictionaries currently being used. 
Order in the list doesn't matter. Some dictionaries on the list 
appear in the correction menu, and some do not. Whether or 
not to appear on the menu is a property of a dictionary. 

Speller Dictionary Management 

Every system includes a basic dictionary, which is in the file 
SYS:SPELL;BASIC.DICT. This is a dictionary of about 30,000 
common English words. Not all words or alternate spellings are 
in the basic dictionary. The dictionary does not include the 
names of Lisp language forms. 

You can add dictionaries for yourself as an individual user, or for 
your site. Any text file can be used as a dictionary. Dictionaries 
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can be in either binary (compiled) format, or character (text) 
format. 

Adding User-specific 

Speller Dictionaries 

The Zmacs Speller checks by default for a Speller dictionary in 
your home directory. This is a standard dictionary and is always 
included on the list of dictionaries if it exists. 

The user-specific dictionary is sought in your directory, on your 
file server, under your name, with the file name "spell" and the 
file type "diet" or "text". 

If you wish to add words to a dictionary as you go along, using 
the Speller, you must read the dictionary in ahead of time. Then, 
any time you click on the dictionary name, the word is added to 
the dictionary in memory. If you wish to add the words to the 
dictionary file on disk, you can save the dictionary. 

See the section "n-X Read Spell Dictionary", page 190. 
See the section "n-X Save Spell Dictionary", page 191. 

See the section "n-X Save All Spell Dictionaries", page 192. 

A dictionary file is just a file of text. Put all the words you want 
in your dictionary into a file in your top-level directory and you 
have a user-specific dictionary. 

To speed loading, you can compile the file. It is good practice to 
use the "text" file type for character (text) dictionary files and 
the "diet" file type for binary (compiled) dictionary files. When 
loading standard dictionaries, the Speller looks first in your 
directory for the file named spell. diet. If that file is not found, 
the Speller looks for spell. text. See the section "n-X Compile 
Spell Dictionary", page 190. 

If you wish to use other dictionaries besides the basic dictionary, 
you can add them to the dictionary list interactively with the n-X 
Read Spell Dictionary command. See the section "n-X Read Spell 
Dictionary", page 190. You can also include other dictionaries on 
your dictionary list using zwei:read-spell-dictionary. Speller 
dictionary functions are most effectively used in a lispm-init file 
to do automatic dictionary operations when you log in. See the 
function zwei:read-speIl-dictionary, page 193. 

For example, evaluating the following form: 
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(zwei : read-spel 1 -di cti onary " f : >ski inpy>my-ol d-1 i st . f oo" ) 

reads that file into memory as a dictionary and adds 
MY-OLD-LIST to the dictionaries named on the menu. In most 
cases, the menu lists just the name of the file and not the rest of 
the pathname, but if two dictionary files have the same name, 
then the menu lists the pathname for both (name-first, like Zmacs 
buffer names). 

Conversely, evaluating this form: 

(zwei : read-spell -dictionary "f :>skiiiipy>my-old-list.foo" nil) 

reads the file into memory as a dictionary, but does not add it to 
the dictionaries named on the menu. See the function zwei:read- 
spell-dictionary, page 193. 

Note: If you use zwei:read-spell-dictionary in your lispm-init file, 
you must also use zwei:read-standard-spell-dictionaries if you 
want to use the standard dictionaries. zwei:read-spell-dictionary 
overrides the auto-loading of the standard dictionaries. 

See the section "Adding Site-specific Speller Dictionaries", page 
189. 

Adding Site-specific 

Speller Dictionaries 

The Zmacs Speller loads the basic dictionary in 
SYS:SPELL;BASIC.DICT when you first use the speller. It is not 
loaded until you request it or need it. 

You can also have other dictionaries designated as site-specific. 
Site-specific dictionaries are always included on the dictionary list 
for each user except for those users who override the auto-loading 
of standard dictionaries by evaluating zwei:read-spell-dictionary 
without also evaluating zwei:read-standard-spell-dictionaries. 
See the section "Adding User-specific Speller Dictionaries", page 
188. 

You can make a dictionary site-specific by adding a USER- 
PROPERTY item to the SITE object in the namespace with the 
keyword SPELL-DICTIONARY and a value that will be parsed as 
a pathname. The namespace editor documentation explains how 
to do this: See the section "Updating the Namespace Database" 
in Networks. 

There is a command processor command for creating a Speller 
dictionary including all the user names for your site. 
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Create Spell Dictionary From Namespace Command 

Create Spell Dictionary From Namespace 
namespace pathname 

Creates a Speller dictionary with all the user-names, first names, 
and last names from the list of USER objects in the namespace. 
(For speed, the command works by accessing the files that hold 
the namespace database rather than by accessing the actual 
namespace servers.) 

namespace The namespace you wish the dictionary to 

represent. 

pathname The pathname of the binary dictionary file to be 

created. 

Once you have created the file, use the namespace editor to make 
it a site-specific dictionary. See the section "Adding Site-specific 
Speller Dictionaries", page 189. 

Speller Dictionary Commands 

Here are the commands for manipulating Speller Dictionaries. 



r\-x Compile Spell Dictionary 

r\-X Compile Spell Dictionary 

Compiles a character (text) dictionary 
into binary format for quicker 
loading. The command prompts for 
two filenames. The first is the 
pathname of the character dictionary, 
which can be any text file. The 
second is the pathname of the binary 
dictionary. Binary dictionary files 
usually have a (canonical) file type of 
"diet". 



n-x Read Spell Dictionary 

n-X Read Spell Dictionary Reads a dictionary from a file. By 

default, the dictionary is added to the 
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n-H Shg\N spell Dictionaries 



menu. When a dictionary is on the 
menu you can add words to it as they 
are checked. With a numeric 
argument, the dictionary is not added 
to the menu. You are prompted for 
the pathname of the dictionary, which 
can be either character (text) or 
binary (compiled). 



n-X Show Spell Dictionaries 

Shows the Hst of dictionaries 
currently being used by the Zmacs 
Speller. 



n-H Save Spell Dictionary 



n-X Save Spell Dictionary Saves an updated copy of a dictionary 

with all words added in the current 
session. You can save any dictionary 
from the list of dictionaries, but it is 
only meaningful to save a dictionary 
from the displayed list, since those 
are the only dictionaries modified. 
Pathnames are unchanged. Saving 
an unmodified dictionary does 
nothing. 

Use n-X Show Spell Dictionaries to 
see the list of dictionaries. 
Completion of dictionary names is 
available. 

See the section "n-X Save All Spell 
Dictionaries", page 192. 
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n-x Save All Spell Dictionaries 



n-X Save All Spell Dictionaries 

Saves updated copies of all modified 
dictionaries on the list of dictionaries. 
Dictionary pathnames are unchanged. 

Use n-X Show Spell Dictionaries to 
see the list of dictionaries. 

See the section "n-X Save Spell 
Dictionary", page 191. 



n-H Kill Spell Dictionary 

n-X Kill Spell Dictionary 



Removes a dictionary from the list of 
dictionaries used by the Zmacs 
Speller. This command has no effect 
on the file on disk. Type in the 
pathname of the dictionary in name- 
first order (like Zmacs buffer names). 
Completion of dictionary names is 
available. 



n-x Add Word to Spell Dictionary 



n-X Add Word To Spell Dictionary 

Adds a word to a dictionary. The 
command prompts for both the word 
and the name of the dictionary. The 
word remains in the dictionary as 
long as the dictionary remains on the 
Hst. 

You can also add a word at the time 
the Speller challenges it, by clicking 
on the dictionary name. 

See the function zwei:add-words-to- 
spell-dictionary, page 194. 
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n-x Delete Word From Spell Dictionary 



n-X Delete Word From Spell Dictionary 

Deletes a word from a dictionary. 
This command prompts for both the 
word and the dictionary. 

See the function zwei:delete-words- 
from-spell-dictionary, page 195. 



n-x Show Contents of Spell Dictionary 



n-X Show Contents Of Spell Dictionary 

Shows all the words in a dictionary. 
Completion of dictionary names is 
available. With a numeric argument, 
the command prompts for a pathname 
and writes the words to that file. In 
this way, you can get a text file of a 
binary dictionary. 

Use n-X Show Spell Dictionaries to 
see the list of dictionaries. 



Speller Dictionary Functions 



zwei:read-spell-dictionary pathname &optional Function 

(menu-p t) 
This function is intended primarily for use in lispm-init 
files. It reads a dictionary from a file into virtual memory 
and adds it to the list of dictionaries used by the Zmacs 
Speller. 

If the optional menu-p argument is nil, the dictionary is 
not added to the dictionaries shown on the menu. The 
default is to show the dictionary on the menu. 

zwei:read-spell-dictionary overrides the auto-loading of 
standard dictionaries. If you use this function in your 
lispm-init file, you must also use 

zweirread-standard-spell-dictionaries if you want the 
standard dictionaries loaded. See the function zwei:read- 
standard-spell-dictionaries, page 194. 
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See the section "Speller Dictionary Management", page 
187. 



zwei:read-standard-spell-dictionaries &key Function 

for-general-use 
This function reads the basic dictionary, any site-specific 
dictionaries, and, optionally, a user-specific dictionary into 
memory and makes them a part of the list of dictionaries 
used by the Zmacs Speller. 

If the optional keyword argument for-general-use is nil, 
only the basic dictionary and any site-specific dictionaries 
are read in. The default is to read in those dictionaries 
plus the user's own user-specific dictionary. Only the 
user-specific dictionary appears on the menu. 

You do not need to evaluate this function in your lispm-init 
file unless you are using zwei:read-spelI-dictionary, which 
overrides the auto-loading of standard dictionaries, or 
unless you wish to set for-general-use to nil. 

See the function zwei:read-spell-dictionary, page 193. 

See the section "Speller Dictionary Management", page 
187. 



zwei:add-words-to-spell-dictionary pathname Function 

list-of-words &optional 

ok-if-dictionary-not-found 
This function adds words to a dictionary in virtual 
memory. Use it to patch a dictionary in a world load that 
already has the dictionary loaded. If the optional 
argument okay-if-dictionary-not-found is t and no dictionary 
is found, nothing happens. If the argument is nil, which 
is the default, the function signals an error. 

For example, 

(zwei : add-words-to-spel 1 -di cti onary " shoebox : >f red>arf narf .diet" 
'("roadhog" "birdbrain") t) 

See the function zwei:delete-words-from-spell-dictionary, 
page 195. 

The dictionary file on disk is not affected. To add a word 
to a dictionary file: 
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See the section "n-X Add Word to Spell Dictionary", page 
192. 

See the section "n-H Save Spell Dictionary", page 191. 

See the section "n-K Save All Spell Dictionaries", page 192. 

zweirdelete-words-from-spell-dictionary pathname Function 

list-of-words &optional 

ok-if-dictionary-not-found 
This function deletes words from a dictionary in virtual 
memory. Use it to patch a dictionary in a world load that 
already has the dictionary loaded. If the optional 
argument okay-if-dictionary-not-found is t and no dictionary 
is found, nothing happens. If the argument is nil, which 
is the default, the function signals an error. 

For example, 

(zwei : del ete-words-f rom-spel 1 -di cti onary " bogue : >1 orna>snage . di ct" 
' ("wonderissimo" "megastupidity") t) 

See the function zwei:add-words-to-speII-dictionary, page 
194. 

The dictionary file on disk is not affected. To delete a 
word from a dictionary file: 

See the section "n-X Delete Word From Spell Dictionary", 
page 193. 

See the section "n-X Save Spell Dictionary", page 191. 

See the section "n-X Save All Spell Dictionaries", page 192. 
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Using Word Abbreviations 



Using word abbreviation, you can type short abbreviations in an 
editing buffer which are expanded into text blocks of any length. 
Thus, you can substitute short, easily typed made-up words and 
have commonly used words, phrases, paragraphs, or program 
elements appear in their place. 

Word Abbrev Mode is a Zmacs minor mode. Turn it on with the 
n-X Word Abbrev Mode command. Turn it off with another n-X 
Word Abbrev Mode command. When Word Abbrev Mode is on, 
you will see the word Abbrev in the mode line. 

Here is an example of using Word Abbrev Mode. Go to an 
editing buffer. For this example, make it a text buffer. Enter 
the n-X Word Abbrev Mode command. Type a word into the 
buffer, such as "Tex". Press c-X c-fl. You are prompted in the 
minibuffer Text mode abbrev for "Tex":. Type "tl" in the 
minibuffer. Now type "tl" and press the space bar. The word 
"Tex" appears in the buffer. 

From now on in this session, any time you type "tl", "Tex" will 
appear. If you want to have "tl" appear in the buffer instead of 
"Tex", type c-X U to Undo the last word abbreviation. 

The expansion is triggered by a space, RETURN, or any punctuation 
mark, including asterisks, ampersands, and other symbols on the 
top row of the keyboard. The trigger is also inserted into the 
buffer. 

If you want to have an abbreviation expand to more than one 
word, you can either select a region before tj^ing c-X c-fl or use 
a numerical argument with c-X for the number of words you want 
to include in the abbreviation. 

c-X c-fl makes word abbreviations only for the current Zmacs 
major mode. Using c-X c-fl in a Lisp buffer makes abbreviations 
that work in all Lisp mode buffer. c-X c-fl in a Text mode buffer 
makes abbreviations that work in all Text Mode buffers, and so 
forth. These are called mode word abbrevs. You can make global 
word abbrevs with c-X +. Global word abbrevs work in any buffer 
except those where a mode word abbrev is defined using the same 
abbreviation. That is, you could have "tl" with a global definition 
of "(FUNCALL STREAM :STRING-OUT STRING)" and still have 
"tl" expand to "Tex" in text buffers. 

If you want to see a list of word abbreviations, use the n-X List 
Word Abbrevs command. 

If you want to save a file of word abbreviations, use the n-X 
Write Word Abbrev File command. To use the word abbreviations 
in a file, use the n-X Read Word Abbrev File command. 
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You can edit the current word abbreviations with the n-X Edit 
Word Abbrevs command. You can put all your word abbreviations 
in a buffer with the n-X Insert Word Abbrevs command and then 
write out the buffer so you can have all your word abbreviations 
in a readable form. Word abbreviation files are written in a 
special format with the "qwabl" file type and are not readable. 

To stop using word abbreviations, you can either turn the mode 
off with the n-X Word Abbrev Mode command, or use the n-X Kill 
All Word Abbrevs command, which eliminates all defined word 
abbreviations. 

You have some control over capitalization in Word Abbrev Mode, 
For instance, with "wabv" as an abbreviation for "word 
abbreviation", "Wabv" expands to "Word abbreviation" and 
"WABV" expands to "WORD ABBREVIATION". Capitalization is 
also controlled by how you enter the word abbreviation in the 
first place. 

Word abbreviations work in the minibuffer, so you can even 
abbreviate commands. If you always type "otehr" when you mean 
"other", then make "otehr" the abbreviation for "other". You can 
also use word abbreviation in programming, for writing reports, 
or in many other editing contexts. 



200 

Text Editing and Processing 



July 1986 



Word Abbreviation Commands 



The word abbreviation commands in this section are listed in 
alphabetical order. 



c-x pi US-SIGN Add Global Word Abbrev 

c-H Plus-sign 



Prompts for a global word 
abbreviation. The default is to make 
a global abbreviation for the word 
preceding point. With a numerical 
argument, the command makes a 
global abbreviation for that many 
words before the point. If a region is 
defined, the command makes a global 
abbreviation for the region. 

Global abbreviations work in all 
buffers unless a mode word 
abbreviation is defined for the 
current buffer mode. See the section 
"c-X c-fl Add Mode Word Abbrev", 
page 200. 



c-x c-R Add IVIode Word Abbrev 

c-X c-R 



Prompts for a mode word 
abbreviation. The default is to make 
a mode abbreviation for the word 
preceding point. With a numerical 
argument, the command makes a 
mode abbreviation for that many 
words before the point. If a region is 
defined, the command makes a mode 
abbreviation for the region. 

Mode abbreviations work in all 
buffers of the same mode as they 
were created in. Lisp mode 
abbreviations work in all Lisp Mode 
buffers. Text mode abbreviations 
work in all Text Mode buffers, and so 
forth. Mode word abbreviations 
override global word abbreviations for 
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buffers of the same mode. That is, 
you can have a global abbreviation 
that works in all buffers except Text 
Mode, and have the same 
abbreviation expand differently in 
Text Mode buffers. See the section 
"c-X pi US-SIGN Add Global Word 
Abbrev", page 200. 

For a prompting form of this 
command: See the section "Make Word 
Abbrev", page 202. 



Edit Word Abbrevs 



Edit Word Abbrevs (n-X) 



Allows you to edit word abbreviations. 
Displays word abbreviations in a 
Word-Abbrev buffer that you can edit 
in the usual fashion. 



Insert Word Abbrevs 



Insert Word Abbrevs (n-X) Inserts a list of word abbreviations 

and their expansions into the buffer. 
You can make a file of this buffer so 
you will have a readable list of the 
word abbreviations you are using, 
word abbreviation files are not 
readable. 



Kill All Word Abbrevs 



Kill All Word Abbrevs (n-X) 



Eliminates all word abbreviations, 
whether read in from a file or 
created interactively with c-X c-R. 
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List Some Word Abbrevs 



List Some Word Abbrevs (n-H) 

Lists word abbreviations or 
expansions that contain a given 
string. Prompts for the string. If 
you have "tl" as an abbreviation for 
"Tex", either "1" or "ex" wiU list the 
abbreviation. 

The command n-X List Word 
Abbrevs, lists all abbreviations and 
expansions. See the section "List 
Word Abbrevs", page 202. 



List Word Abbrevs 

List Word Abbrevs (n-K) 



Lists all word abbreviations and 
expansions. 



Mal(e Word Abbrev 



Make Word Abbrev (n-H) 



Prompts for and creates a new mode 
word abbreviation. Note that this 
command has the same effect as c-X 
c-R Add Mode Word Abbrev. It does 
not make a global abbreviation. 

See the section "c-X c-fl Add Mode 
Word Abbrev", page 200. 



Read Word Abbrev Fiie 



Read Word Abbrev File (n-X) 

Reads in a word abbreviation file 
created with n-X Write Word Abbrev 
File. Abbreviations in the file 
override previously abbreviations, but 
you can add new abbreviations 
interactively. 
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Word abbreviation files are not in a 
readable form. They have the file 
type .qwabl. 



c-x u Unexpand Last Word 



c-X U Unexpand Last Word 



Undoes the last expansion of a word 
abbreviation, leaving the unexpanded 
abbreviation. Thus, if you have "tl" 
as an abbreviation for "Tex", but 
should, for some reason, want to have 
"tl" in your text, you could type "tl" 
and then type c-X U, to get rid of 
"Tex" and leave "tl" behind. 



Word Abbrev Mode 



Word Abbrev Mode (n-X) 



Turns on Word Abbrev Mode. If 
Word Abbrev Mode is already on, this 
command turns it off. Word Abbrev 
Mode is a Zmacs Minor Mode. The 
word Abbrev appears in the mode line 
when Word Abbrev Mode is on. 



Write Word Abbrev File 



Write Word Abbrev File (n-H) 

Takes all the current word 
abbreviations and puts them in a 
word abbreviation file. Word 
abbreviation files are not in a 
readable form. They have the file 
type .qwabl. 

Use the n-X Read Word Abbrev File 
to read in a previously created file of 
abbreviations. See the section "Read 
Word Abbrev File", page 202. 
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A number of Zmacs commands allow you to use different 
character styles. Using character styles, you can indicate 
program structure with different character styles, or you can do 
certain kinds of text formatting. 

For another kind of text formatting: See the section "Zmacs 
Commands for Formatting Text", page 35. 

The information in this chapter deals with these commands only. 
For more information on character styles: See the section 
"Character Styles" in Converting to Genera 7.0. For more 
information on using character styles in programs: See the section 
"Overview of Character Environment Facilities" in Programming 
the User Interface, Volume A. 

A number of choices of character styles are available on the 
Genera system. Here are a few examples: 



DutekJtoli -Italic Small 

Swiss. Bo Id-Condensed-Caps. Normal 

Eurex. Italic. Huge 

Dutch. Roman. Normal 



Zmacs commands allow you to specify the character style for a 
character, word, region, or buffer. (Not all character styles work 
equally well on all printers.) 

Character styles are identified by three characteristics that affect 
how the character appears. These are family, face, and size. The 
names of character styles incorporate these three characteristics. 
Thus, as in the example, you see the family Eurex, the face 
Italic, and the size Huge; this is expressed in commands as 
EUREX.ITALIC.HUGE. This is a fully-specified character style. 

Where you see a character style named as NIL.NIL.NIL (with nils 
in its name), this indicates that the character style is being 
merged against a default style. For instance, the default 
character style for Zmacs buffers is FIX.ROMAN.NORMAL. 
Thus, if you wish a character in a Zmacs buffer to be bold, it can 
be entered as NIL. BOLD. NIL. This means that in the Zmacs 
buffer, its style is merged against FIX. ROMAN. NORMAL to 
produce FIX. BOLD. NORMAL. In some other context. 
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NIL.BOLD.NIL might be interpreted as SWISS. BOLD. NORMAL 
because it was merged against SWISS. ROMAN. NORMAL. A 
character style specification in the form NIL.BOLD.NIL is called 
a character face specification (in contrast to the fully qualified 
specification). 

Here is an example of using character styles. In a Zmacs buffer, 
type a word. Move the cursor back to the beginning of the word. 
Press n-J. You are prompted 

Change character style of word to [default nil .nil .nil] : 



Type in NIL.BOLD.NIL and press RETURN, 
selected appears in bold. 



The word you have 



Now move to the beginning of another word. Press n-J. You see 
the same prompt. This time move the mouse over the word you 
just made bold. You'll see Mouse-L: NIL.BOLD.NIL in the 
mouse documentation line. Click (L). The word you selected is 
emboldened. 

Now move to the beginning of another word. Press n-J. You see 
the same prompt. The arrow cursor points straight up and you'll 
see Mouse-R: Character style menu in the mouse documentation 
line. (If you don't see it, move the mouse a bit and it will show 
up.) Click (R) and a menu appears. 



Character Face Code 



Unspeclflc (fanlly NIL) 

Ronan 

JtAlic 

Bold 

Bold Italic 

Code (fanlly Fix) 

Ronan 

Italic 

Bold ^ 

Bold Italic 

— Text (family Swiss) — 

Roman 

Italic 

Bold 

Botd Italic 

Other style, by Family/Face/Size 



Move the mouse over the first word bold and click any button. 
The word you selected appears in bold. 

The menu allows you many choices of character styles. If you 
click on the item 



Other style by Family/Face/Size 
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you get a series of menus that allows you to select the family, 
faces within that family, and styles available for that combination 
of family and face. Not all families have all faces and sizes 
available. Sizes are relative, for example, SMALL or SMALLER, 
not absolute. 

These are the three ways of selecting a character style. All 
commands for changing character styles allow you to use these 
three methods of specifying the character style you want. 

A common desire is to include a word or phrase in the same 
family, but bold or italic face. If you are typing in a normal 
Zmacs buffer (FIX.ROMAN.NORMAL) you can make a word bold 
by pressing n-J and then simply entering "bold" or just "b" in 
response to the prompt. This is specifying a character face. 

There are six commands for changing character styles. 

c-J (Change Style Character) changes the style of a character, or 
several characters if you use a numeric argument. 

n-J (Change Style Word) changes the style of a word, or several 
words if you use a numeric argument. 

c-X c-J (Change Style Region) changes the style of a region. 

n-H Change One Style Region changes one style in a region, but 
not any other. Thus, if you had a region with both bold and 
italic in it, you could change the italic characters without 
affecting the bold ones. 

n-X Set Default Character Style sets the default character style 
for the whole buffer. The command also prompts to ask if you 
want to set the default character style in the attribute list as 
well. 

c-n-J (Change Typein Style) changes the character style for 
newly inserted characters. 

There are two commands for getting information about character 
styles in a buffer. 

n-X Show Character Styles displays all character styles in the 
buffer or in the region, if there is one. The display includes the 
character style, that is, what you type in to select a character 
style; the Lisp name of the character style; the font equivalent; 
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and samples of the character style. When samples are displayed, 
you can click on the samples to select that character style for any 
of the commands for changing character styles. 

n-X Find Character in Style searches forward for the next 
character in a given style. You supply the name of the character 
style as in the commands for changing or specifying character 
styles. 
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The character style commands in this section are listed in 
alphabetical order. 



Change One Style Region 



Change One Style Region (n-X) 

Allows you to change one character 
style in a region without affecting 
other character styles in the region. 
This command prompts you for the 
style you want to change and the 
style to which you want it changed. 
You can identify the old and new 
styles by typing in the name, by 
clicking with the mouse on the style 
you wish, or by clicking through the 
character styles menu. 

To change all the characters in a 
region to a single style: See the 
section "c-X c-J Change Style 
Region", page 210. 



c-J Change Style Character 



c-J Change Style Character 

This command changes the character 
style of a single character, or, with a 
numeric argument, more than one 
character. You can identify the style 
you want by typing in the name, by 
clicking with the mouse on the style 
you wish, or by clicking through the 
character styles menu. 



c-K c-J Change Style Region 



c-X c-J Change Style Region 

This command allows you to change 
the character style of a region to a 
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single character style. That is, if 
there are two character styles in the 
region, both will be changed to the 
character style you choose with this 
command. You can identify the style 
you want by typing in the name, by 
clicking with the mouse on the style 
you wish, or by clicking through the 
character styles menu. 

To change only one character style in 
a regioniSee the section "Change One 
Style Region", page 210. 



n-J Change Style Word 

n-J Change Style Word 



This command changes the character 
style of a single word, or, with a 
numeric argument, more than one 
word. You can identify the style you 
want by typing in the name, by 
clicking with the mouse on the style 
you wish, or by clicking through the 
character styles menu. 



c-n-J Change Typein Style 



c-n-J Change Typein Style 



This command sets the character 
style for newly inserted characters. It 
does not affect the default style for 
the buffer. You can identify the style 
you want by t3^ing in the name, by 
clicking with the mouse on the style 
you wish, or by clicking through the 
character styles menu. 
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Find Character In Style 

Find Character in Style (n-X) 

This command searches forward for 
the next character in a given style. 
You can identify the style you want 
by typing in the name, by clicking 
with the mouse on the style you wish, 
or by clicking through the character 
styles menu. 



Set Default Character Style 



Set Default Character Style (n-H) 

This command sets or changes the 
character style associated with the 
buffer. You can identify the style you 
want by typing in the name, by 
clicking with the mouse on the style 
you wish, or by cHcking through the 
character styles menu. 



Show Character Styles 



Show Character Styles (n-X) 

This command displays all the 
character styles in a buffer. The 
display includes the character style, 
that is, what you type in to select a 
character style; the Lisp name of the 
character style; the font equivalent; 
and samples of the character style. 
When samples are displayed, you can 
click on the samples to select that 
character style for any of the 
commands for changing character 
styles. 
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Changing Case 



Overview 

Zmacs offers extended commands that convert the case of the 
code for words, regions, and buffers. 

Changing Case of Words 

n-C Uppercase Initial 

Puts next word in lowercase, but capitalizes initial character. 
With an argument, it capitalizes that many words. 

n-L Lowercase Word 

Puts next word in lowercase. With an argument, it puts that 
many words in lowercase. 

n-U Uppercase Word 

Puts next word in uppercase. With an argument, it puts that 
many words in uppercase. 

Changing Case of Regions 

c-X c-U Uppercase Region 

Uppercases the region. 

c-X c-L Lowercase Region 

Lowercases the region. 

Uppercase Code in Region (n-X) 

Converts all code (not comments, strings, or quoted characters) to 
uppercase. This gives the same effect as retyping that text while 
in Electric Shift Lock Mode. It operates on the region if there is 
one, otherwise it operates on the current definition. 

Lowercase Code in Region (n-X) 

Converts all code (not comments, strings, or quoted characters) to 
lowercase. It operates on the region if there is one, otherwise it 
operates on the current definition. 

Changing Case of Buffers 

Uppercase Code in Buffer (n-X) 

Converts all code (not comments, strings, or quoted characters) to 
uppercase. This gives the same effect as retyping that text while 
in Electric Shift Lock Mode. It queries for a buffer name (the 
default is the current buffer) and operates on that buffer. 
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Lowercase Code in Buffer (n-H) 

Converts all code (not comments, strings, or quoted characters) to 
lowercase. It queries for a buffer name (the default is the 
cxirrent buffer) and operates on that buffer. 
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Overview 



Proper indentation helps make complicated Lisp programs 
readable. Indentation should reflect the structure of a program. 
An expression should be indented so that its subforms are easily 
identifiable, and so that a function can be related to its 
arguments by eye, without counting parentheses. 

The indentation commands work in any Zmacs major mode; the 
TAB key indents differently depending on the mode. When you 
give an indent command an argument of /i, n equals the number 
of Space characters in the default font. 



Indenting Current Line 

TRB 

In Lisp mode, the TAB key indents the current line of Lisp code 
correctly with respect to the line above it. (In most other modes, 
TAB inserts a Tab character.) Point remains fixed with respect to 
the code. 

With a numeric argument n, it indents the next n lines including 
the current one, and leaves point at the ;i+lst line. 

c-TAB Indent Differently 

Tries to indent this line differently. If called repeatedly, it makes 
multiple attempts. 

n-TAB Insert Tab 

Inserts a Tab character, even in Lisp Mode, in the buffer at 
point. 

c-n-TAB Indent For Lisp 

Indents this line to make ground (indented) LISP code, even in a 
mode other than Lisp Mode. A numeric argument specifies the 
number of lines to indent. 

Indentation in 
zhloop Macros 

The zhloop Indentor 

Zwei now indents code within a zhloop macro in a more 
attractive way than it did in the past. The TAB key indents the 
code while recognizing and dealing appropriately with zhloop 
keyword clauses. This new indentation style is a change in the 
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Zmacs user interface for writing Lisp code. You might want to 
know how to turn it off because it indents new code in a style 
that is inconsistent with existing code. 

To turn off the new zbloop indentor, include the following flag in 
your init file: 

(SETF ZWEI:*INHIBIT-FANCY-LOOP-INDENTATION* T) 

The initial value for this flag is nil; t reverts to the old-style 
indentor. 

How to Use the 

zI:loop Indentor 

Use the zhloop indentor the same way as always: type a token 
on a line of code inside a zlrloop and then press TAB, which 
correctly indents the code. 

The usual sequence: 

LINE finally TRB 

(substitute any other zI:Ioop word for finally) reindents based on 
the new knowledge that this is a finally line rather than a body 
line. The zhioop indentor always ignores comments. 



Loop Indentor Example 1 

The right indentation sometimes depends on forms after the line 
you are indenting. For example: 

(loop for a being the array-elements of b 
; ; comment 
do (frob a)) 

Press TAB at the end of the comment line and: 

(loop for a being the array-elements of b 
; ; comment 
do (frob a)) 

happens because the zhioop indentor anticipates that you might 
instead be doing this: 

(loop for a being the array-elements of b 
; ; comment 
using (sequence b) (index i) 
do (frob a)) 
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Loop Indentor Example 2 



The zhloop indentor second guesses on a few things, but gets 
them right after you type a token on a hne and press TRB. For 
example; 

(loop when x 
do (y) 
(z)) 

is indented correctly; this is how the indentation initially reads. 
If (z) had been do, it would have put the do where the (z) is: 

(loop when x 
do (y) 
do (z)) 



But pressing TRB reindents it correctly: 

(loop when x 
do (y) 
do (z)) 

The converse can come up, for example: 

(loop with X 
do (z)) 

is fixed with TAB: 

(loop with X 
do (z)) 

(loop with X 
= (z)) 

is indented incorrectly until you press TAB, resulting in: 

(loop with X 
= (z)) 
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Centering the 
Current Line 

n-S Center Line 

Centers the text of the current line within the line. With an 
argument n, it centers n lines and moves past them. 

Indenting New Line 

The keystroke combination RETURN TAB gets you into the right 
position to start typing the next line of code. LINE is the 
abbreviation for that combination. 

LINE Indent New Line 

If the next two lines are blank, goes to the next line; otherwise, it 
creates a new blank line following the current one. In any case, 
it does a TAB on that blank line. 

Reindenting Expression 

c-n-Q Indent Sexp 

Corrects the indentation of the expression following point by 
adjusting the amount of space before each line in the expression. 
c-n-Q positions point in front of the incorrectly indented 
expression. This does not affect the indentation of the current 
line, but only fixes the indentation of following lines with respect 
to the current line. Use after modifying an expression. 

With a numeric argument of /i, it fixes the indentation of the 
next n expressions. 

Indenting Region 

c-n-s Indent Region 

Indents each line in the region. With no argument, it calls the 
current Tab command to indent. With an argument of n, it 
indents each line n spaces in the current font. 

Going Back to 

First Indented Character 

n-N Back To Indentation 

c-n-N 

n-RETURN 

c-n-RETURN 

Positions point before the first nonblank character on the current 
line. 
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Indenting Region Uniformly 

c-x TRB Indent Rigidly 

c-X c-I 

Shifts text in the region sideways as a unit. All lines in the 
region have their indentation increased by the numeric argument 
of the command (the argument can be negative). 

Aligning Indentation 

Indent Under (c-n-X) 

Fixes indentation to align under stringy which you click on with 
the mouse cursor or which you specify in the minibuffer. 

When you use the mouse to specify the alignment string, begin by 
putting the cursor on the line you want to indent, then click 
right, click on Indent Under, then either point the cursor (a 
down-arrow pointing at a box) at a character that you want to 
line up with and click left, or type in a string for which it 
searches. 

When you type the alignment string in the minibuffer, it searches 
back, line by line, forward in each line, for a string that matches 
the one read and that is farther to the right than the cursor 
already is. It indents to align with the string found, removing 
any previous indentation first. 

Deleting Indentation 

n-'^ Delete Indentation 

c-n- 

Deletes the newline character and any indentation at the 
beginning of the current line. It tacks the current line onto the 
end of the previous line, leaving one space between them when 
appropriate, for example, at the beginning of a sentence. 

With any numeric argument, it moves down a line first, thus 
killing the end of the current line. 

New Line with 
This Indentation 

n-0 This Indentation 

Makes a new line after the current one, deducing the new line's 
indentation from point's position on the current line. If point is 
to the left of the first nonblank character on the current line, it 
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indents the new line exactly like the current one. But if point is 
to the right of the first nonblank character, it indents the new 
line to the current position of point. Regardless, it leaves point 
at the end of the newly created line. 

With a numeric argument, the new line is always indented like 
the current one, no matter where point is. With an argument of 
zero, it indents current line to point. 

Moving Rest of 
Line Down 

c-n-0 Split Line 

Moves rest of current line down one line. It inserts a carriage 
return and indents new line directly beneath point. With a 
numeric argument n, it moves down n lines. 

Inserting Blank Line 

c-0 Make Room 

Inserts a blank line after point. With a numeric argument /i, it 
inserts n blank lines. 

Deleting Blank Line 

c-X c-0 Delete Blank Lines 

Deletes any blank lines around the end of the current line. 
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Introduction 



Lisp Machine programmers develop programs in repeated cycles, 
each a sequence of editing, compiling, testing, and debugging. 
These cycles are often nested. Zmacs allows you to edit and test 
large programs d5niamically, without frequent file system 
operations. This manual does not describe any style of 
interacting with the environment in developing Lisp programs. 
See the section "Program Development Tools and Techniques" in 
Program Development Utilities. It focuses on the interaction 
between programmers and the Lisp Machine, presenting ways of 
using helpful Lisp Machine features and tools during each stage 
of program development. 

As a programmer on a Lisp Machine you typically read a file 
containing Lisp code into an editor buffer, make modifications, 
test the results, make more changes, and so on, until satisfied 
with the behavior of the program. Only then do you need to 
write the buffer back out to the file system. The debugging loop 
is much tighter and more responsive than in traditional 
programming environments. You can even evaluate Lisp forms 
directly from inside the editor, without returning to a Lisp 
Listener. Alternatively, you can divide the screen into a Lisp 
Listener window and a Zmacs window, so that you can direct your 
attention to either without changing the display. 

Zmacs provides extensive features for locating source code of 
specified functions. If an error occurs, the Debugger can cause 
Zmacs to read in the source of the function that got the error. 
You can then debug and recompile the function. Similar features 
complement the message-passing capabilities of the Zetalisp 
language. 

When you edit a file with a Lisp type, Zmacs puts that buffer into 
Lisp mode. A command exists for explicitly placing a buffer in 
Lisp mode: 

Lisp Mode (n-X) Lisp Mode 

Places the current buffer into Lisp mode. 



Base and Syntax Default Settings for Lisp 

When you read a file that has a Lisp file type into the buffer, if 
that file does not begin with an attribute line containing Base and 
Syntax attributes, Zmacs warns that the file "has neither a Base 
nor a Syntax attribute" and announces that it will use the 
defaults. Base 10 and Zetalisp. See the section "Buffer and File 
Attributes in Zmacs", page 155. 
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Overview 

Zmacs differentiates between the different comment indicators for 
different major modes. Comments in Lisp begin with a semicolon. 
The Lisp reader ignores eversrthing between a (significant) 
semicolon and the next newline. By convention, there are three 
kinds of comments, beginning with one, two, and three 
semicolons: 

• Comments beginning with a single semicolon are placed to the 
right of a line of code, start in a preset column (the comment 
column), and describe what is going on in that line. 

• A comment with two semicolons is a long comment about code 
within a Lisp expression and has the same indentation as the 
code to which it refers. It describes the function of a group of 
lines. 

• A comment headed by three semicolons is normally placed 
against the left margin, and describes a large piece of code, 
such as a function or group of functions. 

This section outlines Lisp commenting conventions and explains 
Zmacs commands for manipulating comments. 

Indenting for Comment 

c-j Indent For Comment 

n-; 

If the current line has no comment, moves point out to the 
comment column (inserting spaces to get there, if necessary) and 
starts a comment by inserting a semicolon there. If the current 
line already has a comment, it indents it correctly and leaves 
point at the beginning of it. Zmacs positions the various kinds of 
comments appropriately. If a comment begins at the left margin, 
it leaves it there. 

With a numeric argument n, it realigns any comments on the 
next n lines, including the current line, but does not create any 
new comments. 

If a comment cannot be positioned at the comment column 
because the associated line of code is too long, comments are 
moved to the right until they are clearly separated from the code. 

Killing a Comment 

c-n-; Kill Comment 

Kills any comments in the region. If no region exists, kills 
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comments on the current line if no region exists. This command 
can be reversed with Undo if no other undoable command has 
intervened. 

Moving Down to 
Comment on Next Line 

n-N Down Comment Line 

Moves point to the beginning of the comment on the next line. If 
there is no comment on the next line, it creates one. If the 
comment on the current line is empty, it deletes it before going 
to the next line. 

With a numeric argument /i, it moves point to the beginning of 
the comment on the nth line after the current one. 

Moving up to 
Comment on 
Previous Line 

n-P Up Comment Line 

Moves point to the beginning of the comment on the previous 
line. If there is no comment on the previous line, it creates one. 
If the comment on the current line is empty, it deletes it before 
going on to the previous line. 

With a numeric argimient /i, it moves point to the beginning of 
the comment on the ;ith line before the current one. 

Setting the 
Comment Column 

c-X J Set Comment Column 

Sets the comment column to be the current horizontal position of 
the cursor. 

With a numeric argument, it finds the nearest comment above the 
ciurrent line, sets the comment column to line up with that 
comment, and actually puts a comment on the current line at that 
column. 

Creating a New 
Indented Comment Line 

n-LINE Indent New Comment Line 

Makes a new blank line after the current line and starts a new 
comment there, indented properly. If there was already a 
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comment on the current line, the comment on the new line is of 
the same kind. (That is, it has the same mmiber of semicolons 
and is indented the same.) If there was no comment on the 
starting line, n-LINE starts a new line, indenting the new line as 
appropriate for the major mode. 

Inserting and 
Removing Lisp 
Comments From Regions 

c-X c-j Comment Out Region 

Comments out each line in the region. When the region ends at 
the beginning of a line, it does not comment out that line. If any 
part of the line is part of the region, then it does comment out 
that line. 

With a nimieric argument (c-U c-H c-;) the command restores 
lines in the region that have been commented out. When any 
part of the line is part of the region, comments are removed from 
around that line. 

The removal works the same as the commenting out. That is, a 
single semi-colon (;) in column 1 is removed. Removal of 
comments stops at a line without a semi-colon in column 1, even 
if more lines that have been commented out remain in the region. 
The rest of the region does remain in this case, so that you can 
resume. 
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Overview 



The commands in this section form a link between the Zmacs 
editor and the Lisp language. They allow the evaluation and 
compilation of code from Zmacs buffers. These commands are an 
important part of the debugging loop. 

When a Lisp form is being compiled or evaluated, the editor 
displays a message that classifies what is being compiled. 

It classifies macros as functions (because these go in the function 
cell of a symbol). For example: 

Compiling Function SUN 
Evaluating Variable MARS 
Compiling Flavor STAR 



Evaluating Lisp Programs 

n-ESCflPE Evaluate Minibuffer 

Evaluates expressions from the minibuffer. You enter Lisp 
expressions in the minibuffer, which are evaluated when you press 
EMD. The value of the expression itself appears in the echo area. 
If the expression displays any output, that appears as a tj^Deout 
window. 

Evaluate Into Buffer (n-X) 

Evaluates an expression read from the minibuffer and inserts the 
result into the buffer. You enter a Lisp expression in the 
minibuffer, which is evaluated when you press END. The result of 
evaluating the expression appears in the buffer before point. 
With a numeric argument, it also inserts any typeout that occurs 
during the evaluation into the buffer. 

Evaluate Buffer (n-X) 

Evaluates the entire buffer. The result of evaluating the buffer 
appears in the minibuffer. With a numeric argument, it evaluates 
from point to the end of the buffer. 

Evaluate Region (n-X) 
c-sh-E 

Evaluates the region. When no region has been defined, it 
evaluates the current definition. It shows the results in the echo 
area. 
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c-n-sh-E Evaluate Region Verbose 

Evaluates the region. When no region has been defined, it 
evaluates the current definition. It shows the results in a tj^Deout 
window. 

Evaluate Region Hack (n-H) 

Evaluates the region, ensuring that any Lisp variables appearing 
in a defvar have their values set. When no region has been 
defined, it evaluates the current definition. It shows the results 
in the echo area. 

Evaluate Changed Definitions (n-H) 

Evaluates any definitions that have changed in any of the current 
buffers. With a numeric argument, it prompts individually about 
whether to evaluate particular changed definitions (the default 
evaluates all changed definitions). 

Evaluate Changed Definitions of Buffer (n-H) 
n-sh-E 

Evaluates any definitions that have changed in the current buffer. 
With a numeric argument, it prompts individually about whether 
to evaluate particular changed definitions (the default evaluates 
all changed definitions). 

Evaluate And Replace Into Buffer (n-H) 

Evaluates the Lisp object following point in the buffer and 
replaces it with its result. 

c-n-Z Evaluate And Exit 

Evaluates the buffer and exits Zmacs. It selects the window from 
which the last ed function or the last debugger c-E command was 
executed. 

Compiling Lisp Programs 

Compile Buffer (n-X) 

Compiles the entire buffer. With a numeric argument, it 
compiles from point to the end of the buffer. (This is useful for 
resuming compilation after a prior Compile Buffer has failed.) 
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Compile Changed Definitions (n-X) 

Compiles any definitions that have changed in any of the current 
buffers. With a numeric argument, it prompts individually about 
whether to compile particular changed definitions (the default 
compiles all changed definitions). 

Compile Changed Definitions of Buffer (n-X) 
n-sh-C 

Compiles any definitions that have changed in the current buffer. 
With a numeric argument, it prompts individually about whether 
to compile particular changed definitions. The default is to 
compile all changed definitions. 

Compile Changed 
Definitions of Tag Table 

Compile Changed Definitions of Tag Table (n-X) 

Compiles any definitions that have changed in any of the buffers 
in the current tag table. With a numeric argument, the command 
prompts individually about whether to compile particular changed 
definitions. The default is to compile all changed definitions. 

Compile File (n-X) 

Compiles a file, offering to save it first (if it has an associated 
buffer that has been modified). It prompts for a file name in the 
minibuffer, using the file associated with the current buffer as 
the default. It does not load the file. 

Load File (n-X) 

Loads a file, possibly saving and compiling it first. It prompts for 
a file name, taking the default from the current buffer. It checks 
to see if the file you are compiling corresponds to a buffer and 
offers to save that buffer if it is modified. If the .bin file is older 
than the .lisp file, it offers to compile the file first. If the 
typeout window displays any compiler warnings. Load File asks if 
you really want to load the file despite the compiler warnings. 

n-Z Compile And Exit 

Compiles the buffer and exits Zmacs. It selects the window from 
which the last ed function or the last debugger c-E command was 
executed. 
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Lisp Compiler Warnings 

Compiler warnings are kept in an internal database that you can 
inspect and manipulate in various ways with several editor 
commands. 

Compiler Warnings (n-X) 

Creates the compiler warnings buffer (called 
*Compiler-Warnings-1*) if it does not exist, puts all outstanding 
compiler warnings in that buffer, and switches to that buffer. 
You can view the compiler warnings by scrolling around and 
doing text searches through them using Edit Compiler Warnings 
(n-X). 

Edit Compiler Warnings (n-X) 

Prompts you with the name of each file mentioned in the 
database, allowing you to edit the warnings for that file. It then 
splits the Zmacs frame into two windows: the upper window 
displays a warning message and the lower one displays the source 
code whose compilation caused the warning. After you have 
finished editing each function, c-. gets you to the next warning: 
the top window scrolls to show the next warning and the bottom 
window displays the function associated with this warning. 
Successive c-.s take you through all of the warning messages for 
all of the files you specified. When you are done, the last c- . 
puts the frame back into its previous configuration. 

Edit File Warnings (n-X) 

Asks you for the name of the file whose warnings you want to 
edit. You can give either the source file or the compiled file. 
Only warnings for this file are edited. If the database does not 
have any entries for the file you specify, the command prompts 
you for the name of a file that contains the warnings, in case you 
know that the warnings are stored in another file. 

Load Compiler Warnings (n-X) 

Loads a file containing compiler warning messages into the 
warnings database. It prompts for the name of a file that 
contains the printed representation of compiler warnings. It 
always replaces any warnings already in the database. 
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n-( Make () 

Inserts matching parentheses, leaving point between them. With 
a numeric argument ti, it encloses the next n Lisp expressions in 
parentheses. When the number of expressions requested cannot 
be satisfied, it beeps and does nothing. With point on the open 
parenthesis of a defun, an argument of 1 encloses the whole 
defun within a new set of parentheses. Any argument larger 
than 1 would have no effect. In Text Mode, a word or a phrase 
within parentheses is treated as a Lisp form. 

See also the description of the command n-): See the section 
"Motion Among Top-Level Expressions", page 77. 

Matching parentheses in Zmacs Lisp buffers flash in both 
directions. 

The matching open parenthesis flashes when the cursor is sitting 
just past a close parenthesis and the matching close parenthesis 
flashes when the cursor is sitting on an open parenthesis. 
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Two editor commands allow you to expand macros: Macro Expand 
Expression and Macro Expand Expression All. 

c-sh-M Macro Expand Expression 

Heads the Lisp expression following point and expands the form 
itself but not any of the subforms within it. It displays the result 
in the typeout window. With a numeric argument, it pretty-prints 
the result back into the buffer immediately after the expression. 

n-sh-M Macro Expand Expression All 

Heads the Lisp expression following point, and expands all macros 
within it at all levels. It displays the result in the typeout 
window. With a numeric argument, it pretty-prints the result 
back into the buffer immediately after the expression. It assumes 
that every list in the expression is a form, so if car of a list is a 
symbol with a macro definition, the purported macro invocation is 
expanded. 
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Introduction 

The functions that make up a program or system can depend on 
each other in complicated ways. When you are editing one 
function, you sometimes have to go off and look at another 
function, and possibly modify that one too. 

This section describes the Edit Definition command and other 
commands that list and/or edit various sets of definitions. In 
addition, two pairs of List and Edit commands help identify 
changed code by finding or editing changed definitions in buffers. 
By default, the changed commands find changes made since the 
file was read; use numeric arguments to find definitions that have 
changed since they were last compiled or saved. 

The Zmacs Edit 
Definition Commands 

Edit Definition (n-.) is a powerful command to find and edit 
function definitions, macro definitions, global variable definitions, 
and flavor definitions. In general, Zmacs treats as a definition 
any top-level expression having in functional position a s3niibol 
whose name begins def. 

It is particularly valuable for finding source code, including 
system code, that is stored in a file other than that associated 
with the current buffer. It finds multiple definitions when, for 
example, a sjnnbol is defined as a function, a variable, and 
another tj^e of object. It maintains a list of these definitions in 
a support buffer. 



Zmacs Command: n-- 

This command is one of the most valuable tools of the system. 
When you are developing or debugging programs, you can use n-. 
to find the definition of an ordinary function, generic function, 
flavor, method, variable, package, or other type of definition. 
Completion is supported on the definition, if it is already in an 
editor buffer. 

n-. prompts for a definition to find. You can enter a large 
variety of representations, and n-. figures out what definition you 
are seeking. For example, you can enter symbols with or without 
package prefixes. 

You can provide any of the following responses to the n- . prompt: 
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symbol Finds the definition of symbol, which can be an 

ordinary function or generic function. For 
generic functions, the defgeneric form is found 
if one exists; all existing methods are also 
found, symbol can also be one of: variable, 
package, defstruct structure, flavor, or other 
types of definitions. 

(generic-function flavor) 

Finds the definitions of one method that 
implements generic-function on instances of 
flavor and asks if you mean that method. If 
not, it proceeds to find other methods, including 
special-purpose methods such as :before, rafter, 
rdefault, and so on. 

(symbol property) Finds the function named by function spec 
(.-property symbol property). This is a handy 
abbreviation. 

function-spec Finds the definitions of function-spec. For 

example, you could enter (flavor: method 
change-status cell) to find the method of that 
function spec. Often it is more convenient to 
enter the list (change-status cell) instead. 

When the requested Lisp object has multiple definitions, one of 
them is displayed. You can then use c-U n-. to cycle through 
the other definitions. Also, a list of all definitions and the files 
they are located in is stored in a buffer called *Definitions-7i*. 
The position of the cursor in that buffer controls where c-U n- . 
will go next. 

You can also point at forms with the mouse, in a buffer or in 
other windows, and click n-left to edit the definition. 

Example of the n- . Command 

Suppose you are modifying a function called sun, which was 
written by someone else, sun calls the unfamiliar luna, and you 
need to find out what Ixma does before proceeding. Use n-. to 
peek at the definition of luna. 

When you t5T)e n-., Zmacs prompts you for the name of a 
definition. If point is in the expression where luna is called, the 
default name is luna, and you need only press END. If point is 
somewhere else and the default is wrong, you can point at the 
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word luna with the mouse or you can type it in. To let you know 
that you can define a name with the mouse, the mouse cursor 
changes to an arrow pointing straight up. All the symbols that 
are names of definitions you could specify become mouse 
sensitive. 

Edit Installed Definition (n-X) 

Edits the installed version of the file that contains the definition 
of a specified Lisp object. It prompts for the name of the 
definition; if one of your buffers already contains the installed 
version of that definition, it selects that buffer. Otherwise, it 
reads in the source file that contains the definition. It always 
positions the cursor in front of the definition. When the object 
has more than one definition, use a numeric argument to edit 
another definition of the same object. You can repeat this until 
there are no more definitions of that object. 

Edit Changed Definitions (n-X) 

Determines which definitions in any Lisp Mode buffer have 
changed and selects the first one. It makes an internal list of all 
the definitions that have changed since the buffer was read in 
and selects the first one on the list. Use c-. (Next Possibility) to 
move to subsequent definitions. See the section "Displaying the 
Next Possibility", page 126. 

Edit Changed Definitions accepts a numeric argument to control 
the time point for determining what has changed: 

Value Meaning 

1 For each buffer, since the file was last read (the default). 

2 For each buffer, since the buffer was last saved. 

3 For each definition in each buffer, since the definition was 
last compiled. 



Edit Changed Definitions of Buffer (n-X) 

Determines which definitions in the current buffer have changed 
and selects the first one. It makes an internal list of all the 
definitions that have changed since the buffer was read in and 
selects the first one on the list. Use c-. (Next Possibility) to 
move to subsequent definitions. See the section "Displaying the 
Next Possibility", page 126. 
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Edit Changed Definitions of Buffer accepts a numeric argument to 
control the time point for determining what has changed: 

Value Meaning 

1 Since the file was last read (the default). 

2 Since the buffer was last saved. 

3 Since the definition was last compiled. 



Edit Cp Command 

Edit CP Command (n-H) 

Reads the source of a CP command into an editor buffer. With a 
numeric argument, prompts for a comtab. Otherwise it looks for 
the command in the global comtab. 

Edit System Files 

Edit System Files (n-X) 

Reads all of the files of a system into buffers. With a numeric 
argument, the files of the component system are also read into 
buffers. 

The List Detinition Commands 

List Definitions (n-X) 

Displays the definitions in a specified buffer. It reads the buffer 
name from the minibuffer, using the current buffer as the 
default. It displays the list as a typeout window. The individual 
definition names are mouse sensitive. 

List Duplicate Definitions (n-X) 

Displays the duplicate definitions in the current buffer, if any. 
This is especially useful for checking patch files or files made by 
merging several programs together, c-. (Next Possibility) moves 
point to duplicate definitions that occur earlier in the file, 
beginning with the earliest duplicate and not including the latest 
dupUcate. See the section "Displaying the Next Possibility", page 
126. 

List Changed Definitions (n-X) 

Displays a Ust of any definitions that have been edited in any 
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buffer. Use c-. (Next Possibility) to start editing the definitions 
in the list. See the section "Displaying the Next Possibility", 
page 126. 

List Changed Definitions accepts a numeric argument to control 
the time point for determining what has changed: 

Value Meaning 

1 For each buffer, since the file was last read (the default). 

2 For each buffer, since the buffer was last saved. 

3 For each definition in each buffer, since the definition was 
last compiled. 

List Changed Definitions of Buffer (n-X) 

Displays the names of definitions in the buffer that have changed. 
It makes an internal list of the definitions changed since the 
buffer was read in and offers to let you edit them. Use c- . 
(Next Possibility) to move to subsequent definitions. See the 
section "Displaying the Next Possibility", page 126. 

List Changed Definitions of Buffer accepts a numeric argument to 
control the time point for determining what has changed: 

Value Meaning 

1 Since the file was last read (the default). 

2 Since the buffer was last saved. 

3 Since the definition was last compiled. 



The Edit Callers Commands 

When you are modif3dng a large system, you often have to make 
sure that changing a function does not render unusable other 
functions that call the modified one. Zmacs provides facilities for 
editing the sources of all the functions defined in the current 
world that call a given one. This removes some of the 
unpleasantness of making incompatible changes to large programs 
and is a good example of how Zmacs interacts with the Lisp 
environment to make programming easier. 
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Edit Callers (n-X) 

Prepares for editing all functions that call the specified one. The 

prompt is the same kind that Edit Definition gives you. It reads 

a function name via the mouse or from the minibuffer with 

completion. 

It selects the first caller; use c-. (Next Possibility) to move to a 
subsequent definition. See the section "Displajdng the Next 
Possibility", page 126. 

Multiple Edit Callers (n-X) 

Prompts for the names of a group of functions and edits those 
functions in the current package that call any of the specified 
ones. It reads a function name from the minibuffer, with 
completion, initially offering a default function name. It 
continues prompting for more function names until you end the 
list with RETURN. 

Use n-X Multiple Edit Callers Intersection when you want to edit 
those functions that call all of the specified functions. See the 
section "Multiple Edit Callers Intersection", page 240. 

Multiple Edit 
Callers Intersection 

Multiple Edit Callers Intersection (n-X) 

Prepares for editing all the functions that call all of the specified 
functions. It reads a function name from the minibuffer, with 
completion. It continues prompting for a function name until you 
end it with just a carriage return. 

Use n-X Multiple Edit Callers if you want to edit all the functions 
that call any of the specified functions. See the section "Multiple 
Edit Callers ". 

List Callers (n-X) 

Prompts for the name of a function exactly the way Edit Callers 
does, but instead of editing the callers in the current package of 
the specified function, it simply displays their names. The names 
are mouse-sensitive. If you point at one and click left, you can 
edit the source of that caller. If you click right, a menu pops up 
that offers to give the argument list of the selected caller, to 
disassemble it, to edit it, or to see its documentation string. In 
addition, c-. (Next Possibility) works in this context, offering the 
first caller to be edited, and queuing up the other callers to be 
edited in sequence. 
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Multiple List Callers (n-X) 

Lists all the functions that call any of the specified functions. It 
reads a function name from the minibuffer, with completion. It 
continues prompting for more function names until you end the 
list with RETURN. 

The list of function names is mouse-sensitive: see List Callers 
(n-X). C-. (Next Possibility) edits the callers. See the section 
"Displaying the Next Possibility", page 126. 

Use n-X Multiple List Callers Intersection when you want only 
callers that call all the specified functions. See the section 
"Multiple List Callers Intersection", page 241. 

Multiple List Callers Intersection 

Multiple List Callers Intersection (n-X) 

Lists all the functions that call all of the specified functions. It 
reads a function name from the minibuffer, with completion. It 
continues prompting for a function name until you end it with 
just a carriage return. 

Use n-X Multiple List Callers if you want to list functions that 
call any of the the specified functions. 

See the section "The Zmacs Edit Callers Commands", page 239. 
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For complete information about patching: See the section "Patch 
Facility" in Program Development Utilities. 

Making Patches 

During a typical maintenance session you might make several 
changes to existing definitions or write new ones. Rather than 
recompiling the entire system every time you change a source file, 
you can copy only the new or revised code into a patch file and 
write the file ("finish" the patch). Whenever you finish a patch, 
the patch facility automatically compiles the file and records the 
event in a "patch registry" for the system, noting the number of 
the patch, the system being patch, and a brief user-supplied 
description. As soon as a user loads the patch file (after the 
system is loaded), the state of the given system in his or her 
machine is presumably the same as in the developer's machine 
when the patch was finished. 

The patch facility allows you to have several patches in progress 
at once. Thus you can patch several different systems or several 
different minor versions of the same system during one work 
session. The patch facility manages this potentially dangerous 
situation in the following way. Every time you start a patch, a 
number and a place in the patch registry is reserved for the 
patch in production. The patch is marked in-progress. When the 
patch is finished, the entry is completed and the in-progress mark 
removed. If you decide to abort the patch, the registry entry is 
automatically deleted. 

The ability to have more than patch in-progress to more than one 
system makes it imperative that you keep track of the state of 
your various patches. If a patch is left unfinished (unwritten), 
the load-patches function will load neither the in-progress patch 
or any subsequent finished patches. 

The patch facility considers patches to be active or inactive and 
in one of the following states: initial, in-progress, aborted, or 
finished. Show Patches (n-X) displays the state of all patches 
started in this work session. If more than one patch is in 
progress, one of them is known as the current patch. The 
commands that add patches, like Add Patch (n-X), add only to the 
patch considered by the patch facility to be the current patch. 
The command Select Patch (n-X) displays a menu of active 
patches and allows you to make another patch the current one. 

In general you should adhere to the following steps in making a 
patch. It is assumed that your system is patchable; that is, the 
:patchable option appears in the system declaration. 
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1. You must load (via load-system) the major version of the 
system that you want to patch. 

2. Read in the source files you want to edit into a Zmacs buffer. 
Make all changes and test them thoroughly. Write the source 
file. 

3. Use the appropriate Zmacs commands to make your patch. 
Begin the patch, using Start Patch (n-«). 

4. Add the changed code to the patch buffer by using Add Patch 
(n-H), Add Patch Changed Definitions of Buffer (n-X), or Add 
Patch Changed Definitions (n-X). 

. 5. Finish the patch, using Finish Patch (n-X), or abort the patch, 
/uvV'K:'! using Abort Patch (n-X). 

Commands provided for initiating a patch are Start Patch (n-X), 
Start Private Patch (n-X), and Add Patch (n-X). 

Start Patch (n-X) 

Starts a new patch, prompting you for the name of the system to 
be patched; it miistbe„a_ system currently loaded. It assigns a 
new minor version number for that particular system by writing a 
new version of the patch directory file with an entry for that 
minor version number. The patch is marked as in-progress. It 
starts constructing the patch file in an editor buffer, but does not 
select the buffer. 

While you are making your patch file, the minor version number 
that has been allocated for you is reserved so that nobody else 
can use it. Thus, if two people are patching the same system at 
the same time, they cannot be assigned the same minor version 
number. 

The command does not actually move any definitions into the 
patch file. You must explicitly do so with Add Patch Changed 
Definitions of Buffer (n-X), Add Patch Changed Definitions (n-X), 
or Add Patch (n-X). 

The patch facility permits you to start another patch before 
finishing the current one. However, if your new patch is to the 
same system, the patch facility warns you that you already have a 
patch in progress and allows you to take one of four actions: 

• Abort the in-progress patch and start a new patch. 

• Finish the in-progress patch and start a new patch. 

o Proceed with the second patch (initial patch) for this system 
and leave the in-progress patch intact. 
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• Use the existing buffer and do not start a new patch. 

Start Private Patch (n-X) 

Although similar to Start Patch (n-X), Start Private Patch (n-X) 
does not have any relationship to systems, major and minor 
version numbers, and official patch directories. Rather it allows 
you to make a private patch file that you can load, test, and share 
with other users before you install a numbered patch that is 
automatically available to all users. 

Instead of prompting for a system name, the command prompts 
for a file name. Start Private Patch does not actually move any 
definitions into the patch file. Use Add Patch Changed 
Definitions of Buffer (n-X), Add Patch Changed Definitions (n-X), 
or Add Patch (n-X) to insert the code. Finishing the patch (using 
Finish Patch (n-X)) writes it out to the specified file. 

Note: Use the Load File command or Load File (n-X) to load a 
private patch; the Load Patches command and the load-patches 
function do not load private patches. 



Add Patch (n-X) 



Starts a new patch if none is underway, prompts you for a system 
name, and inserts the region or current definition into the patch 
buffer. If a patch was in progress. Add Patch (n-X) just adds the 
region or current definition to the current patch file. 

If you mistakenly use the command on code that does not work, 
select the buffer containing the patch file and delete it. Then 
later you can use Add Patch (n-X) on the corrected version. For 
each patch you add, it queries for a patch comment, which it then 
inserts in the patch file. Just pressing EMD means "no comment". 



Add Patch (n-X), Add Patch Changed Definitions (n-X), or Add 
Patch Changed Definitions of Buffer (n-X) insert code into the 
patch file. If the patch is being made to the system the current 
buffer's file came from, the commands proceed. 

If there is a current patch, and it is not appropriate for the 
system that the buffer's file came from, you see a menu showing 
all of the current patches, plus an option to create a new patch 
appropriate for the buffer, plus an option to abort. 
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Add Patch Changed 

Definitions of Buffer (n-X) 

Add Patch Changed Definitions of Buffer (n-X) selects each 
definition that was changed in the buffer and asks you whether or 
not you want the definition patched. 

For each definition, you can respond as follows: 

Response Action 

Y Patches the definition. 

N Skips the definition. 

P Patches the definition and any additional modified 

definitions in the same buffer without asking any 
more questions. 

A definition needs to be patched if it has been changed since it 
was last patched or if it has not been patched since the file was 
read into the buffer. 

For each patch you add, it queries for a patch comment, which it 
then inserts in the patch file. Just pressing EMD means "no 
comment". 

Add Patch Changed 

Definitions (n-X) 

Add Patch Changed Definitions (n-X) selects a buffer in which 
definitions were changed and asks whether or not you want to 
patch the changed definitions. Answering N skips the buffer and 
proceeds to the next buffer, if any. Answering Y selects each 
definition that has changed in that buffer and asks you whether 
or not you want the definition patched. For each definition, you 
can respond as follows: 

Response Action 

Y Patches the definition. 

N Skips the definition. 

P Patches the definition and any additional modified 

definitions in the same buffer without asking any 
more questions; when done, it proceeds to the next 
buffer. 

If there are more buffers containing definitions to be patched, it 
asks questions again when it gets to the next buffer. 
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A definition needs to be patched if it has been changed since it 
was last patched or if it has not been patched since the file was 
read into the buffer. 

For each patch you add, it queries for a patch comment, which it 
then inserts in the patch file. Just pressing END means "no 
comment". 



When making multiple patches during one work session use the 
Select Patch and Show Patches commands to keep track of 
patches. 



Select Patch (n-X) 

When you are making more than one patch during a work session, 
Select Patch (n-X) allows you to choose a different patch as the 
current patch from a menu of active patches. The patching 
commands (like Add Patch and Add Patch Changed Definitions of 
Buffer) insert definitions into the patch file that you have selected 
as the current patch. To insert patch definitions into another 
buffer, use Select Patch to choose that buffer as the current 
patch. 

Show Patches (n-X) 

Show Patches (n-X) displays the state of all patches started in 
this session. Patches are either active or inactive and can be in 
one of the following states: initial, in-progress, aborted, or 
finished. Inactive patches are in an aborted or finished state. 
Active patches are in an initial or in-progress state. Initial means 
that the patch buffer has been initialized but as yet no definitions 
have been added to the buffer. In-progress means that the patch 
buffer has been initialized and definitions have been added to the 
buffer. 

Show Patches groups the active and inactive patches and 
identifies the current patch. 



After making and testing all of your patches, use the Finish 
Patch command to install the patch in the system. 
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Finish Patch (n-X) 

Finish Patch (n-X) installs the patch file so that other users can 
load it. This command saves and compiles the patch file (patches 
are always compiled). If the compilation produces compiler 
warnings, the command asks whether or not you want to finish 
the patch anjnvay. If you do, or if no warnings are produced, a 
new version of the patch directory file is written. The in-progress 
mark is removed from the entry in the patch registry. 

The command allows you to edit the patch comments, which are 
written to the patch directory file, (load-patches and 
zhprint-system-modifications print these comments.) It then asks 
you whether you want to send mail about the patch. If you say 
"yes", it opens a mail buffer and inserts initial contents, including 
the name of the patch file and your patch comment. 

Note; By default the Finish Patch command queries you about 
sending mail. You can alter this behavior by changing the value 
of the variable zwei:*send-mail-about-patch*. Its valid values 
are :ask, the default value, which queries the user; t, which opens 
a Zmacs mail buffer without querying; and nil, which takes no 
action regarding the sending of patch mail. 



Sometimes you start making a patch file and for a variety of 
reasons do not finish it - for example, you decide to abort the 
patch, you need to end your work session at this machine, or your 
machine crashes. In each of these situations it is of the utmost 
importance that you leave the patch directory file in a clean state; 
that is, either go back and finish the patch (as soon as possible!) 
or deallocate the patch number reserved to you. Failure to do so 
has unfortunate consequences: users at your site will not be able 
to load patches. 

In your machine has crashed, use Resume Patch (n-X) to reclaim 
access to the patch number previously assigned to you. You can 
continue with the patch (assuming you saved the source files just 
prior to the crash) or use Abort Patch (n-X) to deallocate the 
patch number. Begin the patch again if you wish. If you simply 
decide to abandon the patch file, then just use Abort Patch. If 
you must boot your machine before finishing the patch, then save 
the patch buffer and as soon as possible use Resume Patch to 
read in the relevant patch file; finish the patch or abort it, as you 
wish. 
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Abort Patch (n-X) 

Abort Patch (n-X) deallocates the minor version number that was 
assigned by the Start Patch or Add Patch commands. It tells 
Zmacs that you are no longer interested in making the current 
patch and offers to kill the patch buffer. The next time you do 
Add Patch (n-X), Zmacs starts a new patch instead of appending 
to the one in progress. 

Resume Patch (n-X) 

Resume Patch (n-X) allows you to return to a patch that you were 
not able to finish in the same boot session in which you started 
it; for example, your machine might have crashed or you had to 
boot your machine suddenly. It reads in the relevant patch file if 
it was previously saved; otherwise it just reclaims your access to 
the minor version number allocated to you when you started the 
patch. Abort or finish the patch. 



Under certain circumstances you might find it necessary to 
recompile and reload a patch file. 



Recompile Patch (n-X) 

Recompile Patch (n-X) recompiles an existing patch file. This 
command is useful when, for example, an existing patch needs to 
be edited or a compiled patch file becomes damaged in some way. 
Never recompile a patch manually or in any way other than using 
the Recompile Patch command. This command ensures that 
source and object files are stored where the patch system can find 
them. 

Use Recompile Patch with caution! Recompiling a patch that has 
already been loaded by other users can cause divergent world 
loads. 

Reload Patch (n-X) 

Reload Patch (n-X) reloads an existing patch file. This command 
makes it easy to reload a patch file without having to know its 
pathname. 



You might want to have your herald announce private patches 
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that you make, note-private-patch adds a private patch to the 
database in your world and includes the name of the patch in the 
herald. 



note-private-patch string Function 

Adds a private patch to the database in your world. 
note-private-patch takes a string argument. For example, 
the following adds the private patch called patch.lisp: 

(note-pri vate-patch " s : >smi 1 1 er>patch . 1 i sp" ) 

Subsequent displays of your herald show the inclusion of 
that patch in your world. 

You create private patches using the Start Private Patch 
(n-X) command and then the standard patch commands for 
adding to and finishing the patch. Use the Load File 
command or Load File (n-X) to load a private patch; the 
load patches command and the load-patches function do 
not load private patches. 
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Overview 



Introduction 



Now that you are familiar with the basic Zmacs concepts and 
techniques, you can set up a large set of minor modes, Zmacs and 
Lisp variables, and parameters to change the way the editor 
works. Zmacs's flexibility allows you to change which keys are 
connected to which commands, write your own commands, and 
install them in lieu of the standard system commands. A few 
users make extremely radical changes to the point where almost 
every key has a new meaning. 

This section describes: 



o Zmacs minor and major modes, and how they provide a degree 

of customization 
o Creating new commands with keyboard macros 
o Saving keyboard macros 
o Setting key bindings 
o Specifying Zmacs variable settings 
« Sample init file forms for automatically reloading your 

customized environment 
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Definition of 
Minor Modes 

A minor mode: 

• Is an option. 

• Is independent of other minor modes and of the selected major 
mode. 



How It Works 



Zmacs has an extended command for each minor mode (n-X) that 
turns the mode on or off. With no argument, the command turns 
the mode on if it was off and off if it was on. This is known as 
toggling. A positive argument always turns the mode on, and a 
zero argument or a negative argument always turns it off. 

All the minor mode commands are suitable for connecting to 
single- or double-character commands if you want to enter and 
exit a minor mode frequently. See the section "Zmacs Key 
Bindings", page 267. 

For information about setting minor modes permanently: See the 
section "Setting Mode Hooks in Init Files", page 273. 



Example 



Auto Fill Mode (n-X) 

Turns on Auto Fill Mode, a minor mode that inserts Return 
characters automatically to break lines as you iY?Q. You can turn 
Auto Fill Mode on regardless of your major mode. If the mode 
line displays Fill, Auto Fill Mode is on. If Auto Fill Mode is 
already turned on, this command turns it off. 

This mode is useful when you are typing large amounts of text. 
It makes it unnecessary to look at the screen or to worry about 
line length: you just type in the text without newlines and Zmacs 
inserts them whenever they are needed. 

Auto Fill Mode works by establishing a hook that runs after you 
press one of the activation characters (SPHCE, RETURN, -, ?, !, or 
]) that activate filling in this mode. When you press one of these 
characters in Auto Fill Mode, Zmacs does more than simply insert 
it. First it checks to see whether the line exceeds the maximum 
allowable line length or fill column (see Set Fill Column below). 
If the line is too long, Zmacs finds the last word on the current 
line that fits inside the fill column. Zmacs then inserts a newline 
right after that word. Extra spaces (if any) are deleted from the 
beginning of the newly formed line. 
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Because of the way Auto Fill Mode works, you will often find 
yourself typing a word out beyond the fill column. The word will 
be moved to the next line as soon as you press one of the 
activation characters. 

The fill column is used by Auto Fill Mode (and by the paragraph 
adjusting commands) to decide where to break lines. It is 
measured in pixels, not in characters, so that Auto Fill Mode 
works even if characters of different widths appear in a buffer. 
(A pixel is a tiny rectangular area on the screen that is either all 
white or all black. Pixels are the smallest addressable region of 
the display. If you look closely, you can see the separate 
rectangular pixels that make up everything on the display.) 

You can change the fill column with the following command: 

c-X F Set Fill Column 

Changes the fill column to match up with the current position of 
the cursor. That means that if point is at the end of a line, filled 
lines will not be longer than the current one from now on. You 
are given a choice of whether to set the fill column for the 
buffer, the major Zmacs mode, or globally. 

With a positive numeric argument n less than 200, the fill 
column is set to be ti character-widths, and if n is 200 or greater, 
the fill column is set to be ti pixels. 

In effect, this command sets the right margin. Auto Fill mode 
and the n-Q use the fill column setting. 

Summary of Minor Modes 

Atom Word Mode (n-X) 

Makes word-moving commands, in Lisp mode, move over Lisp 
objects (other than lists and nil instead of words. This command 
does not display anjrthing in the mode line. 

Auto Fill Lisp Comments Mode (c-n-X) 

Turns on auto filling of comments, but not code. This command 
displays Fill -Comments in the mode line. 

Auto Fill Mode (n-X) 

Turns on auto filling. Auto Fill mode allows you to type text 
endlessly without worrying about the width of your screen. 
Return characters are inserted where needed to prevent lines 
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from becoming too long. This command displays Fill in the mode 
line. 

Electric Font Lock Mode (n-X) 

Puts comments in font B. This command displays 
Electric Font-lock in the mode line. 

Electric Shift Lock Mode (n-X) 

Facilitates typing in programs that are in uppercase. Whenever 
you type a character that is part of a Lisp symbol, such as the 
name of a function, variable, or special form, Zmacs inserts it in 
uppercase, but when you type a character that is part of a 
character string or a comment or after a slash, Zmacs inserts it 
normally. This command displays Electric Shift-lock in the mode 
line. 

EMACS Mode (n-X) 

Provides commands for EMACS users. It puts bit-prefix 
commands on ESCAPE, c-'", and c-C, and Universal argument on 
c-U. It also makes c-I a synonym for TAB, c-H a synonym for 
BACKSPACE, and c-] a synonjnn for ABORT. This command displays 
EMACS in the mode line. 

Overwrite Mode (n-X) 

Turns on overwrite mode. In overwrite mode, ordinary printing 
characters replace existing text, instead of inserting themselves 
next to it. It is good for editing pictures. This command displays 
Overwrite in the mode line. 

Word Abbrev Mode (n-X) 

Allows you to define word abbreviations that expand as you type 
them. This command displays Abbrev in the mode line. 



256 

Text Editing and Processing July 1 986 



Major Modes 



User-Defined 
Major Modes 

In Zmacs, you can define your own major modes (see 
zweitdefmajor in the code). 

File Types and 
Major Modes 

You can control the default major mode associated with a 
particular file tj^De. For example, Zmacs sets the major mode to 
Lisp for files with tj^De lisp. The repository for this information 
is a list called fs:*file-type-mode-alist*. 

For example, suppose you wanted to associate the file type tex 
with text mode: 

(push '("tex" . :text) fs:*file-type-ruode-alist*) 

The car of an element should be either a canonical type symbol 
or a string when the type is not one of the known canonical 
types. 

In addition, suppose you have files that would require Scribe 
mode, if Zmacs had such a thing. You can define a 
correspondence between two major modes, using a global variable 
called zwei:*major-mode-translations*. It is an alist of major 
mode names, expressed as ke3rword symbols. 

Example: 

(push '(rscribe . :text) zwei :*major-modB-translations*) 
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Definition 



How It Works 



A keyboard macro is a command that you define to abbreviate a 
sequence of other commands. If you discover that you are about 
to type c-N c-D 40 times, you can define a keyboard macro to do 
c-N c-D and call it with a repeat count of 40. 

The keyboard macros described here are temporary keyboard 
macros; that is, macros that you use for the duration of your 
Zmacs session. For information on writing permanent keyboard 
macros that you can save and initialize in your init file: See the 
section "Writing and Saving Keyboard Macros", page 259. 



You define a keyboard macro by telling Zmacs that you are about 
to write a macro and then typing the commands that are the 
definition. That is, as you are defining a keyboard macro, the 
definition is being executed for the first time. When you are 
finished, the keyboard macro is defined and also has been, in 
effect, executed once. You can then do the whole thing over 
again by invoking the macro. 



Procedure 



1. To start defining a keyboard macro, type c-X ( 

(Start Kbd Macro). From then on, your commands continue to 
be executed, but also become part of the definition of the 
macro. Macro-level : 1 appears in the mode line. 

2. If you want to perform an operation on each line, do one of the 
following: 

« Start by positioning point on the line above the first one to 
be processed and then begin the macro definition with a c-N 

• Start on the proper line and end with a c-M. 

Either way, repeating the macro operates on successive lines. 

3. After defining the body of the macro, you can terminate it in 
several ways. 

o c-X ) (End Kbd Macro) terminates the definition. 

« An argument of zero to c-X ) automatically repeats the 

macro (upon termination of the definition) until it gets an 

error or reaches the end of the buffer. 

• c-X ) can be given a repeat count as a numeric argument, in 
which case it repeats the macro that many times right after 
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defining it, but defining the macro counts as the first 
repetition (since it is executed as you define it). (Subsequent 
invocations ignore the numeric argument contained in the 
macro.) 
Inserting an argument of 5 before ending the macro (-..c-5 c-X 
)) executes the macro immediately four additional times. 

Starting a 
Keyboard Macro 

c-H ( Start Kbd Macro 

Begins defining a keyboard macro. A numeric argument means 
append to the previous keyboard macro. 

Ending a 
Keyboard Macro 

c-« ) End Kbd Macro 

Terminates the definition of a keyboard macro. 

Showing a 
Keyboard Macro 

To see the keyboard macro, use Show Keyboard Macro (n-X), 
which prints the macro at the top of your screen. 

Show Keyboard Macro (n-X) 

Displays the specified keyboard macro. The name of the macro is 
read from the minibuffer; just RETURN means the last one defined, 
which can also be temporary. 

Calling the Last 
Keyboard Macro 

The macro thus defined can be invoked again with c-X E (Call 
Last Kbd Macro), which can be given a repeat count as a numeric 
argument to execute the macro many times. 

c-X E Call Last Kbd Macro 

Repeats the last keyboard macro. 



Example 



The example below defines a keyboard macro that goes to the 
beginning of a line, inserts a semicolon, and goes to the next line. 
It also executes the macro four times, including once as it is 
being defined. 
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c-K ( 
c-A 

c-N 

c-4 c-X ) 



For information about setting key bindings permanently: See the 
section "Zmacs Key Bindings", page 267. 

Writing and 

Saving Keyboard Macros 

Writing and saving keyboard macros entails: 

« Defining the macro with zwei:define-keyboard-macro. 
• Installing the macro on a keystroke with 

zwei: make-macro-command. 
» Storing the macro into a comtab with zweircommand-store. 

zwei:define-keyboard-macro takes as its arguments the name of 
the macro and the keystrokes specifying what you want it to do. 

Optionally, you can install the macro on a keystroke with 
zwei:inake-macro-coininand, giving the name of the macro, 
which returns a Lisp function. 

zwei: command-store takes that Lisp function and stores it into a 
comtab, similar to what zweitset-comtab does. 
zwei: command-store, given the key you want to install the macro 
on and the comtab in which to put it, stores the command in the 
slot of the comtab that you specify. The combination of 
zwei:make-macro-command and zwei: command-store does the 
same thing as the Install Macro (n-X) command. 

Using variations of the following forms you can save the macros 
on disk and, if you wish, edit them. 
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Example 1 



Example 2 



Suppose you want to have a command that exchanges the first 
two words on a line. Put this form in your init file: 

(ZWEI:DEFINE-KEYBOARD-MACRO EXCH-FIRST-TWO-WORDS (NIL) 
#\C-A #\M-F #\M-T) 

The macro cannot be more than 255 keystrokes long. If your 
macro gets this long you should be writing in Lisp, since 
keyboard macros are not intended to be a programming language. 
If necessary, you can get around this restriction by breaking your 
macro into parts and having them call each other. 

Suppose you want to install the EXCH-FIEST-TWO-WORDS 
macro on the keystroke s-Q. Put this form in your init file: 

(ZWEI: COMMAND-STORE (ZWEI : MAKE-MACRO-COMMAND ': EXCH-FIRST-TWO-WORDS) 
#\S-Q ZWEI:*ZMACS-COMTAB*) 



The following form defines a keyboard macro called repl ace-test, 
which replaces the string dog with the string river: 

(ZWEI:DEFINE-KEYBOARD-MACRO REPLACE-TEST (NIL) 
#\C-S "dog" #\ESCAPE #\M-RUBOUT "river") 

To save the keyboard macro repl ace-test on the keystroke h-S: 

(ZWEI: COMMAND-STORE (ZWEI : MAKE-MACRO-COMMAND ': REPLACE-TEST) 
#\H-S ZWEI:*ZMACS-COMTAB*) 

The h-S command takes a numeric argument as a repeat count. 



Defining an 
Interactive 
Keyboard Macro 

Within the keyboard macro definition, you can specify steps at 
which you want the macro to query. To define an interactive 
keyboard macro, use the Kbd Macro Query command after 
beginning the macro definition (with Start Kbd Macro). Invoke 
Kbd Macro Query at each spot in the macro where you want the 
macro to query. Then close the definition with End Kbd Macro. 
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c-X Q Kbd Macro Query 

Allows user interaction on each iteration of macro, similar to 
Query Replace (n-X). While defining a keyboard macro, press c-X 
Q at each step where you want a pause to occur. Upon execution 
of the macro, it stops and waits at each of those steps for one of 
the following characters: 

SPACE Continues execution of the macro. 

RUBOUT Skips rest of keyboard macro (use nested c-X ( 

and c-X ) for grouping to control range of 
skip). 

? or HELP Displays HELP information. 

Continues but does not iterate anymore. 

! Continues, iterates, but does not ask anymore. 

c-R Enters editing mode; c-n-FUNCTION R resumes 

the keyboard macro. 



Naming a 
Keyboard Macro 

Having defined a keyboard macro, you can name it with Name 
Last Kbd Macro (n-X). A prompt (Name for macro:) appears in 
the minibuffer. 

Name Last Kbd Macro (n-X) 

Assigns a name to the most recent temporary keyboard macro, 
making it permanent. The new name for the macro is read from 
the minibuffer. 

Using Keyboard 
Macros to Sort 

You can use a keyboard macro to set up a sorting mechanism and 
run it on any region of text. 

For information about how to sort using keyboard macros, see the 
description of Sort Via Keyboard Macros (n-X): See the section 
"Overview of Sorting in Zmacs", page 128. 

Installing a Macro 
on a Key 

To bind the macro to the key of your choice, use Install Macro 
(n-X). You are asked to identify the macro and specify the key(s) 
to which you want it bound. 
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Install Macro (n-X) 

Installs a specified user macro on a specified key. The name of 
the macro is read from the minibuffer, and the keystroke on 
which to install it is read in the echo area. If the key is 
currently holding a command prefix (such as c-H), it asks you for 
another character, so that you can redefine c-X commands. 
However, with a numeric argument, it assumes you want to 
redefine c-X itself, and does not ask for another character. 

Installing a Mouse Macro 

You can bind the macro to a mouse click instead of a key using 
Install Mouse Macro (n-X). This command works similarly to 
Install Macro. 

Install Mouse Macro (n-X) 

Installs a specified user macro on a specified mouse click The 
name of the macro is read from the minibuffer, and the mouse 
click on which to install it is read in the echo area. When the 
mouse is clicked to invoke this macro, the macro is invoked from 
the current location of the mouse cursor. 

Deinstalling a Macro 

To remove the macro from that key, use Deinstall Macro (n-X). 
The key is rebound to the standard system usage, if any. 

Deinstall Macro (n-X) 
Deinstalls a keyboard macro. 



Example 



This example shows how to install a macro and deinstall the same 
macro: 

you type: n-X Install Macro 

minibuffer: Name of macro to install (CR for last macro defined) 

you type: nacro-nane or CR 

minibuffer: Key to get it: 

you type: h-T 
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A menu appears and asks you in which comtab to install the macro: 

• Just this editor 

• Zmacs 

• Zwei 

Click on your choice. 

mini buffer: Command #<DTP-CLOSURE 34465726> installed on Hyper-T 

you type: n-X Deinstall Macro 

minibuffer: Key to deinstall: 

you type: h-T 

The menu appears and asks you to specify in which of the three 
comtabs to deinstall the macro. Click on your choice, 

minibuffer: Command NIL installed on Hyper-T. 

For information about saving keyboard macros permanently: See 
the section "Zmacs Key Bindings", page 267. 

Making Tables 

Using Keyboard Macros 

The keyboard macro facility implemented with the c-n-FUIiCTION 
key provides more features, such as an easy way to make tables. 

c-n-FUNCTION 

Reads a keyboard macro command, consisting of an optional 
numeric argument made up of any number of digits (0-9) followed 
by a non-numeric character, usually a letter. Each keyboard 
macro command must be preceded by the c-n-FUNCTION prefix. 
After typing the prefix, you may type HELP for a list of available 
keyboard macro commands. 

Keyboard Macro Commands for c-n-FUNCTION 

0-9 Optional numeric argument. 

C Calls a macro by name. Prompts in the minibuffer for the 

name of the macro. 

P Begins a macro definition (same as c-X ( - See the 

section "Starting a Keyboard Macro", page 258.) 
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R Ends a macro definition (same as c-X ) - See the section 

"Ending a Keyboard Macro", page 258.) 

M Defines a named macro. Prompts for the name of the 

macro to define and then enters macro definition mode. 

S Stops (aborts) macro definition (also c-G). 

D Defines a named macro but does not execute it while 

reading its characters. 

SPRCE Inserts pauses for user interaction in the macro (same as 
c-X Q - See the section "Defining an Interactive Keyboard 
Macro", page 260.) 

fl Steps though characters on successive iterations (for 

example, letters and numbers). Asks for starting 
character, amount to increase (or decrease if negative) on 
each iteration. 

U Allows t5T)ein terminated by c-n-FUMCTION R. This allows 

you to stop while in the middle of defining the macro, do 
other things in the editor, and then go back and finish 
defining the macro. 

T Allows typein every iteration. 

The difference between c-n-FUNCTION U and c-n-FUMCTION T is 
that c-n-FUNCTION U allows typein while defining a macro. This 
typein does not get stored in the macro, and therefore does not 
get executed on subsequent iteration, nor when the macro is 
called again. 

c-n-FUNCTION T allows typein on every iteration. As with 
c-n-FUNCTION U, the t3npein while defining the macro does not get 
stored in the macro. But on each subsequent iteration, new 
typein will be requested. 



Example 1 



The following example shows how to create a macro that 
constructs a table using c-n-FUNCTION fl. 
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you type: c-« ( 

Minibuffer: Macro-level: 1 * 

you type: c-n-FUNCTION n 

Minibuffer: Initial character (type a one-character string): 

you type: a RETURN 

Minibuffer: Amount by which to increase it (type a decimal number) 

you type: 1 RETURN 

(Zmacs inserts the a into the buffer.) 

you type: c-2 c-6 c-X ) 

As you close the macro, Zmacs inserts into the buffer: 

abcdefghi j kl mnopq rstuvwxyz 

by executing the macro 26 times, increasing the letter once each 
time. 



Example 2 



The following example shows how to create a macro that 
constructs a table using c-n-FUNCTION fl, and this time, 
c-n-FUNCTION T, which allows typein during every iteration of the 
macro: 
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you type 

Minibuffer 
you type 
you type 

Minibuffer 
you type 

Minibuffer 
you type 
you type 
you type 

Minibuffer 
you type 
you type 

Minibuffer 
you type 
you type 
you type 
you type 
you type 
you type 
you type 
you type 
you type 
you type 



c-X ( 

Macro-level: 1 * 

Item SPACE 

c-n-FUMCTION R 

Initial character (type a one-character string): 

1 

Amount by which to increase it (type a decimal number) 

1 

TAB 

c-n-FUNCTION T 

Macro-level : 2 * 

Rosemary 

c-n-FUNCTION R 

Macro-level: 1 * 

RETURN 

c-5 c-X ) 

Sage 

c-n-FUNCTION R 

Thyme 

c-n-FUNCTION R 

Parsley 

c-n-FUNCTIOM R 

Pepper 

c-n-FUNCTION R 



The table looks like this: 



Item 1 


Rosemary 


Item 2 


Sage 


Item 3 


Thyme 


Item 4 


Parsley 


Item 5 


Pepper 
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Definition 

A key binding is the set of specific keystrokes that invoke a 
specific command. 

How Key Bindings 
Work: the Comtab 

A command table, or comtab, assigns a command to each possible 
keystroke. While Zmacs is running, there is always a unique 
selected comtab, in which Zmacs finds the command that 
corresponds to each user keystroke. 

When you type a keystroke, Zmacs looks up the keystroke in the 
currently selected comtab, finds the appropriate command, and 
runs it. Usually the command's side effects all occur within the 
buffer: Point might be moved and text might be deleted, 
inserted, or rearranged. Sometimes a command has more 
extensive side effects. A command can alter or replace the 
selected comtab itself, in which case Zmacs looks up the next 
keystroke in the new command table. 

Zmacs's basic state consists of the standard editor key bindings, 
which reside in one special command table, the standard comtab 
(Zivei comtab). The standard comtab interacts with the Zmacs 
comtab and the various mode-dependent comtabs. The typical 
selected comtab when in Zmacs is "unnamed" for mode-specific 
key bindings, which indirects to "Zmacs", which indirects to 
"Zwei". Although the standard comtab can be temporarily 
replaced, it is always reselected eventually, often after only one 
"nonstandard" keystroke. 

A keystroke that functions as a prefix actually runs a command 
that replaces the standard comtab for one keystroke. This is the 
mechanism by which multikeystroke commands are implemented. 
For example, there are many two-stroke commands whose first 
keystroke is c-X. This keystroke runs a command that brings in 
its own comtab before interpreting the next stroke. 

Setting the Key 

If you want to put a command on the keystroke of your choice, 
use Set Key. This command works for any of the already defined 
commands. 

Set Key (n-X) 

Installs a specified command on a specified key. If the key is 
currently holding a command prefix (such as c-X), it asks you for 
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another character so that you can redefine c-X commands. 
However, with a numeric argument, it assumes you want to 
redefine c-X itself £ind does not ask for another character. 

It assigns key bindings in the editor that are active in all buffers, 
and takes two arguments: the name of a command, and a 
keystroke to invoke it. It reads the name of the command in the 
minibuffer, completing any command name in any comtab. 

Install Command 

If you want to put a function on the keystroke of your choice, use 
Install Command. It takes a function, regards it as a command, 
and puts it on a key. 

Install Command (n-X) 

Installs a specified function as a command in the comtab, on a 
specified key. It takes two arguments: the name of the function 
(the current definition, that is, top-level expression), and a 
keystroke to invoke it. (Zmacs treats as a definition any top-level 
expression having in functional position a sjmibol whose name 
begins "def".) If the key is currently holding a command prefix 
(such as c-X), it asks you for another character so that you can 
redefine c-X commands. However, with a numeric argument, it 
assimies you want to redefine c-X itself and does not ask for 
another character. 
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Definition 

A variable is a name that is associated with a value, for example, 
a number or a string. Zmacs has editor variables that you can 
set for customization. (Variables can also be set automatically by 
major modes.) 

You can distinguish the names of Zmacs variables from other Lisp 
variables by their names - the first letters are capitalized and the 
names contain spaces rather than h3^hens. 

Finding Out About 
Zmacs Variables 

To examine the value of a single Zmacs variable, use Describe 
Variable (n-X). To print a complete list of all variables, use List 
Variables (n-X). 

Some commands refer to variables that do not exist in the initial 
environment. Such commands always use a default value if the 
variable does not exist. In these cases you must create the 
variable yourself if you wish to use it to alter the behavior of the 
command. 

Describing Zmacs Variables 

Describe Variable (n-X) 

Displays the documentation and current value for a single Zmacs 
variable. It reads the variable name from the minibuffer, using 
completion. 

Listing Zmacs Variables 

List Variables (n-X) 

Lists all Zmacs variables and their values. With a numeric 
argument, this command also displays the documentation line for 
the variable. 

Listing Variables 

by Matching a String 

HELP U Variable Apropos 

c-HELP U 
c-n-? U 

Displays the names of all possible Zmacs variables containing a 
specific substring. With a numeric argument, this command also 
displays the documentation lines for the variables. 
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Example 

One example of such a Zmacs variable is the Fill Column 
variable, which specifies the width, in pixels, used in filling text. 

For example, c-1 HELP U prompts in the minibuffer Variable 
Apropos (substring): and you tj^ie fill col. It does pattern 
matching on the variable name and thus matches Fill column, 
which displays: Fill column: 576. Width in pixels used in 
filling text. 

Setting Variables 

Settable Zmacs Variables 

You can view all settable Zmacs variables with the List Variables 
command. 

The following are some examples of variables that can be set with 
Set Variable. In addition, they can be set in init files by using 
the internal form of their names. For example, Region Marking 
Mode is zwei:*region-marking-mode* internally. 



Region Marking Mode 

Value: :reverse-video for setting the region to 
reverse video. The default is tunderline. 



Region Right Margin Mode 

Value: t. Causes whatever marks the region 
(reverse video or underlining) to extend across 
unfilled space to the right margin. The default is 
nil. 
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One Window Default 

Controls which window remains selected after a 

One Window (c-X 1) command when you were 

using more than one window. Possible values: 

: current 

: other 

:top 

:bottoin 

This feature operates best when the current layout 
has no more than two windows. The value 
tcurrent is the only one that is always well defined 
with more than two windows on the screen. 



Set Variable 



Check Unbalanced Parentheses When Saving 

Controls whether Zmacs checks a file for 
unbalanced parentheses when you are saving the 
file. The check is on (t) by default. When it 
checks a file that you are saving and finds 
unbalanced parentheses, it queries you about 
whether to go ahead and save anyway. This applies 
to all major modes based on Lisp; it is ignored for 
text modes. 



Set Variable (n-H) 

Sets any existing Zmacs variable. This command reads the name 
of a variable (with completion), displays its current value and 
documentation, and prompts in the minibuffer for a new value. It 
does some checking to see that the new value has the right type. 

Although either uppercase or lowercase works, you are encouraged 
to capitalize each word of the name for aesthetic reasons, since 
Zmacs stores the name as you give it. 
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Introduction 

As you gain sophistication with the more advanced features, you 
will find the settings of parameters that most please you and put 
these into a command file (init file) that the system executes 
every time you log in. 

Creating an Init File 

Create a file named lispm-init.lisp (or with the correct Lisp file 
type suffix for your host operating system) in your home directory 
on your host system and put your Zmacs customizations there. 

This section contains examples of forms that you can place inside 
a login-forms in your init file to customize the editor. 

login-forms is a special form for wrapping around a set of forms 
in your init file. It evaluates the forms and arranges for them to 
be undone when you log out. 

Setting Editor Variables 

The forms described show how to set Zmacs variables (the kind 
that Set Variable (n-X) sets). 

To set these variables, which are symbol macros, you must use 
the zl:setf macro. For a description of symbol macros: See the 
section "S3nnbol Macros" in Symbolics Common Lisp. For a 
description of the zhsetf macro: See the macro zlrsetf in 
Symbolics Common Lisp. 

Ordering Buffer Lists 

(SETF ZWEI:*SORT-ZMACS-BUFFER-LIST* NIL) 

This displays the list of buffers in the order the buffers were 
created rather than in the order they were most recently visited. 



Putting Buffers Into 
Current Package 



(SETF ZWEI:*DEFAULT-PACKAGE* NIL) 

This puts buffers created with c-X B (Select Buffer) into whatever 
package is current; the default is to put them in the 
user package. 
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Setting Default 
Major Mode 



(SETF ZWEI:*DEFAULT-MAJOR-MODE* ':TEXT) 

This sets the default major mode to Text Mode for buffers with 
no Mode attribute and no major mode deducible from the file 
type; the default is Fundamental Mode. 



Setting Find File 

Not to Create New Files 



(SETF ZWEI:*FIND-FILE-NOT-FOUND-IS-AN-ERROR* T) 

This beeps and prints an error message when you give 
c-X c-F (Find File) the name of a nonexistent file. The default 
prints (New File) and creates an empty buffer, which when saved 
by c-X c-S (Save File) creates the file that was nonexistent. 



Setting Goal 
Column for Real 
Line Commands 



(SETF ZWEI:*PERMANENT-REAL-LINE-GOAL-XPOS* 0) 

This moves subsequent c-N and c-P (Down Real Line and Up 
Real Line) commands to the left margin, like doing 
c-0 c-X c-N (Set Goal Column to zero). 

Fixing White Space 

for Kill/Yank Commands 

(SETF ZWEI:*KILL-INTERVAL-SMARTS* T) 

This tells the killing and yanking commands optimize white space 
surrounding the killed or yanked text. 

Setting Mode Hooks 

Each major mode has a mode hook, a variable which, if bound, is 
a function that is called with no arguments when that major 
mode is turned on. 



Electric Shift Lock 
in Lisp Mode 



(SETF ZWEI : LISP-MODE-HOOK 'ZWEI :ELECTRIC-SHIFT-LOCK-IF-APPROPRIATE) 
This tells Lisp major mode to turn on Electric Shift Lock minor 
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mode unless the buffer has a Lowercase attribute. The effect is 
that by default Lisp code is written in upper case. 

Auto Fill in Text Mode 

(SETF ZWEI: TEXT-MODE-HOOK 'ZWEI : AUTO-FILL-IF-APPROPRIATE) 

This tells Text major mode to turn on Auto Fill minor mode 
unless the buffer has a Nofill attribute. The effect is that by 
default lines of text are automatically broken by carriage returns 
when they get too wide. 

Key Bindings 

To bind keys, you first define the comtab in which to put the 
binding. For example, *standard-comtab* and 
*standard-control-x-cointab* define features of all Zwei-based 
editors; *zmacs-comtab* and *zmacs-control-x-comtab* define 
features that are Zmacs-specific. 

White Space in Lisp Code 

ZWEI : (SET-COMTAB *STANDARD-CONTROL-X-COMTAB* 

'(#\SP COM-CANONICALIZE-WHITESPACE)) 

This defines c-H SPACE as a command that makes the horizontal 
and vertical white space around point (or around mark if given a 
numeric argument or immediately after a yank command) conform 
to standard style for Lisp code. 

c-n-L on the 
SQUARE Key 

ZWEI : (SET-COMTAB *ZMACS-COMTAB* 

* (#\SQUARE COM-SELECT-PREVIOUS-BUFFER)) 

This defines the SQUARE key to do the same thing as c-n-L. This 
key binding is placed in *zmacs-comtab* rather than 
*standard-comtab* since buffers are a feature of Zmacs, not of 
all Zwei-based editors. 

Edit Buffers on c-X c-B 

ZWEI : (SET-COMTAB ^ZMACS-CONTROL-X-COMTAB* 
'(#\c-B COM-EDIT-BUFFERS)) 

This makes c-H c-B invoke Edit Buffers rather than List Buffers. 
This key binding is placed in *zmacs-control-x-comtab* rather 
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than *standard-control-x-comtab* since buffers are a feature of 
Zmacs, not of all Zwei-based editors. 



Edit Buffers on n-X 



n-, on r\-(L) 



ZWEI:(SET-COMTAB *ZMACS-COMTAB* 



(MAKE-COMMAND-ALIST ' (COM-EDIT-BUFFERS))) 

This makes Edit Buffers available on n-X in Zmacs (by default it 
is only available on c-n-X). 



ZWEI:(SET-COMTAB *ZMACS-COMTAB* 

' (#\in-MOUSE-L COM-EDIT-DEFINITION)) 

This makes clicking the left mouse button while holding down the 
METR key do what n-. does. Invoking this command from the 
mouse is convenient when you specify the name of the definition 
to be edited by pointing at it rather than typing it. 
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This section lists the names of the available help commands grouped according to 
the context in which they are available. The purpose of this section is to 
summarize the capabilities and to help you determine both the overall contexts for 
which you can find help and a particular function that might be what you are 
looking for. 
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Edit Buffers (n-X) 

Edit Changed Definitions (n-X) 

Edit Changed Definitions Of Buffer (n-H) 

List Buffers (c-K c-B) 

List Changed Definitions (n-X) 

List Changed Definitions Of Buffer (n-X) 

List Definitions (n-X) 

List Matching Lines (n-X) 

Print Modifications (n-X) 

Select System as Tag Table (n-X) 

Tags Search (n-X) 
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Apropos (n-X), HELP fl 

Describe Variable (n-H) 

Edit Zmacs Command (n-X) 

List Commands (n-H) 

List Registers (n-X) 

List Some Word Abbrevs (n-X) 

List Tag Tables (n-X) 

List Variables (n-X) 

List Word Abbrevs (n-X) 
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Describe Variable At Point (c-sh-U) 

Edit Callers (n-X) 

Edit CP Command n-X 

Edit Definition (n--) 

Edit File Warnings (n-X) 

Function Apropos (n-X) 

List Callers (n-H) 

List Matching Sjmibols (n-X) 

Long Documentation (c-sh-D) 

Multiple Edit Callers (n-X) 

Multiple List Callers (n-X) 

Quick Arglist (c-sh-fl) 

Show Documentation (n-sh-D) 

Show Documentation Function (n-sh-fl) 

Show Documentation Variable (n-sh-V) 

Where Is Symbol (n-X) 
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Describe Flavor (n-X) 

Show Documentation Flavor (n-sh-F) 

Edit Combined Methods (n-X) 

Edit Methods (n-H) 

List Combined Methods (n-H) 

List Methods (n-X) 
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Break (SUSPEND) 

Compile And Exit (n-Z) 

Compile Buffer (n-X) 

Compile Changed Definitions (n-H) 

Compile Changed Definitions Of Bxiffer (n-«), n-sh-C 

Compile File (n-X) 

Compile Region (n-X), c-sh-C 

Compiler Warnings (n-X) 

Edit Compiler Warnings (n-X) 

Evaluate And Exit (c-n-Z) 

Evaluate And Replace Into Buffer (n-X) 

Evaluate Buffer (n-X) 

Evaluate Changed Definitions (n-X) 

Evaluate Changed Definitions Of Buffer (n-X), n-sh-E 

Evaluate Into Buffer (n-X) 

Evaluate Minibuffer (ESCAPE) 

Evaluate Region (n-X), c-sh-E 

Evaluate Region Hack (n-X) 

Evaluate Region Verbose (c-n-sh-E) 

Load Compiler Warnings (n-X) 

Macro Expand Expression (n-X), c-sh-M 

Trace (n-X) 

Quit (c-Z) 
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16. Font Basic Concepts 



On the Symbolics Lisp Machine, characters can be typed out in any of a number 
of different t3^efaces. Some text is printed in characters that are small or large, 
boldface or italic, or in different styles altogether. Each such typeface is called a 
font. A font is conceptually an array, indexed by character code, of pictures 
showing how each character should be drawn on the screen. The Font Editor 
(FED) is a program that allows you to create, modify, and extend fonts: See the 
section "Font Editor", page 283. 

A font is represented inside the Lisp Machine as a Lisp object. Each font has a 
name. The name of a font is a symbol, usually in the fonts package, and the 
symbol is bound to the font. A typical font name is tr8. In the initial Lisp 
environment, the sjonbol fonts:tr8 is bound to a font object whose printed 
representation is something like: 

#<FONT TR8 23471 2342> 

The initial Lisp environment includes many fonts. Usually there are more fonts 
stored in BFD files in file computers. New fonts can be created, saved in BFD 
files, and loaded into the Lisp environment; they can also simply be created inside 
the environment. 

If you are loading a font contained in a font file in one of the font directories, the 

system loads that font the first time you reference it. However, if you are loading 

a font contained in a file somewhere else in the file system, load that font using ■ '■■'■^; 

the function fedrread-font-from-bfd-file j^afA/iame, where pathname is the //' 

pathname of the font file. See the section ":Load-bfd Transformation of 

Defsystem^. ' '^ 

The zl-user:tv package contains the window system, which includes fonts for 
screen display (as opposed to fonts for hardcopying). 



16.1 Attributes Of TV Fonts 

Fonts, and characters in fonts, have several interesting attributes. 

Character Height Font Attribute 

One attribute of each font is its character height. This is a nonnegative integer 
used to figure out how tall to make the lines in a window. Each window has a 
certain line height. The line height is computed by examining each font in the 
font map, and finding the one with the largest character height. This largest 
character height is added to the vertical spacing (in pixels) between the text lines 
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(vsp) specified for the window, and the sum is the line height of the window. The 
line height, therefore, is recomputed every time the font map is changed or the 
vsp is set. This ensures that any line has enough room to display the largest 
character of the largest font and still leave the specified vertical spacing between 
lines. One effect of this is that if you have a window that has two fonts, one 
large and one small, and you do output in only the small font, the lines are still 
spaced far enough apart to accommodate characters from the large font. This is 
because the window system cannot predict when you might, in the middle of a 
line, suddenly switch to the large font. 

Baseline Font Attribute 

Another attribute of a font is its baseline. The baseline is a nonnegative integer 
that is the number of raster lines between the top of each character and the base 
of the character. (The base is usually the lowest point in the character, except for 
letters that descend below the baseline, such as lowercase p and g.) This number 
is stored so that when you are using several different fonts side-by-side, they are 
aligned at their bases rather than at their tops or bottoms. So when you output a 
character at a certain cursor position, the window system first examines the 
baseline of the current font, then draws the character in a position adjusted 
vertically to make the bases of the characters all line up. 

Character Width Font Attribute 

The character width can be an attribute either of the font as a whole, or of each 
character separately. If there is a character width for the whole font, it is as if 
each character had that character width separately. The character width is the 
amount by which the cursor position should be moved to the right when a 
character is output on the window. This can be different for different characters 
if the font is a variable-width font, in which a W might be much wider than an 
i. Note that the character width does not necessarily have anything to do with the 
actual width of the bits of the character (although it usually does); it is merely 
defined to be the amount by which the cursor should be moved. 

Left Kern Font Attribute 

The left kern is an attribute of each character separately . Usually it is zero, but 
it can also be a positive or negative integer. When the window system draws a 
character at a given cursor position, and the left kern is nonzero, the character is 
drawn to the left of the cursor position by the amount of the left kern, instead of 
being drawn exactly at the cursor position. In other words, the cursor position is 
adjusted to the left by the amount of the left kern of a character when that 
character is drawn, but only temporarily; the left kern only affects where the 
single character is drawn and does not have any cumulative effect on the cursor 
position. 



287 
July 1986 Font Editor 



Fixed-width Font Attribute 

A font that does not have separate character widths for each character and does 
not have any nonzero left kerns is called a fixed-width font. The characters are 
all the same width and so they line up in columns, as in t3rpewritten text. Other 
fonts are called variable-width because different characters have different widths 
and things do not line up in columns. Fixed-width fonts are typically used for 
programs, where columnar indentation is used, while variable-width fonts are 
typically used for English text, because they tend to be easier to read and to take 
less space on the screen. 

Biini<er Widtti and BiinicerHeigiit Font Attributes 

The blinker width and blinker height are two nonnegative integers that tell the 
window system an attractive width and height to make a rectangular blinker for 
characters in this font. These attributes are completely independent of all other 
attributes and are only used for making blinkers. Using a fixed width blinker for 
a variable-width font causes problems; the editor actually readjusts its blinker 
width as a function of what character it is on top of, making a wide blinker for 
wide characters and a narrow blinker for narrow characters. The easiest thing to 
do is to use the blinker width as the width of the blinker. This works well with a 
fixed-width font. 

Ctiars-exist-tabie Font Attribute 

The chars-exist-table is nil if all characters exist in a font, or an sysiart-boolean 
array. This table is not used by the character-drawing software; it is for 
informational purposes. Characters that do not exist have pictures with no bits 
"on" in them, just like the Space character. Most fonts implement most of the 
printing characters in the character set, but some are missing some characters. 



16.2 Standard TV Fonts 

You can use Show Font HELP in the Lisp Listener or the List Fonts (n-X) command 
in Zmacs to get a list of all the fonts that are currently loaded into the Lisp 
environment. The zI-user:fonts package contains the names of all fonts. Here is 
a list of some of the useful fonts: 

fonts:cptfont This is the default font, used for almost everj^hing. 

fonts:jessl4 This is the default font in menus. It is a variable- 

width rounded font, slightly larger and more 
attractive than medfnt. 
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fontsrcptfonti 



fontsrcptfontcb 

fonts:medfnt 

fontsrmedfnb 

fonts:hll2i 

fonts:trlOi 
fonts:hllO 
fontsrhllOb 



This is a fixed-width italic font of the same width and 
shape as fonts: cptfont, the default screen font. It is 
most useful for italicizing running text along with 
fonts:cptfont. 

This is a fixed-width bold font of the same width and 
shape as fontstcptfont, the default screen font. 

This is a fixed-width font with characters somewhat 
larger than those of zl-user: cptfont. 

This is a bold version of zl-iiser:medfnt. When you 
use Split Screen, for example, the [Do It] and [Abort] 
items are in this font. 

This is a variable-width italic font. It is useful for 
italic items in menus; Zmail uses it for this in several 
menus. 

This is a very small italic font. It is the one used by 
the Inspector to say "More above" and "More below". 

This is a very small font used for nonselected items 
in Choose Variable Values windows. 

This is a bold version of zl-iiser:hI10, used for 
selected items in Choose Variable Values windows. 
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17. Entering and Leaving FED 



You can enter FED: 

• By using [Font Edit] in the System menu. 

• By typing the Edit Font command at any Lisp Listener, 
o By typing the zlrfed Lisp form at any Lisp Listener. 

The first time you invoke FED in a session, it takes about 15 seconds to start up; 
after that, entering FED is very quick. When the startup is complete, you see a 
FED Frame, the window configuration used by FED. You are not editing any 
particular font: you can experiment with character drawing in this state, but it is 
best to select a font first. 

If you know which font you wish to edit before entering FED, you can save time 
and steps by typing the font-name as an argument to Edit Font or zl:fed: 

Edit Font font-name 

or 

(fed font-name) 

font-name can be a string, a BFD object, or any atomic S3mibol (on any package) 
whose print name is the name of the font you wish to edit. 

You can exit FED either by selecting some other activity (via the System menu, 
mouse, the SELECT key, or FUNCTIOM S), or by using [EXIT] in FED's menu. 
Whenever you reinvoke FED in the same session, you return to the editing that 
you were doing when you left FED. Thus, only one FED exists per session, and 
you do not lose your work by leaving it. 

Should FED become unusable because of an error, you can type the following form 
at a Lisp Listener: 

(fed : reinitial ize) 

This creates a completely new FED (although not destroying the old one). 
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18. Font Editor Basic Concepts 



18.1 FED, the Subsystem 



FED accepts both menu commands and character (keyboard) commands. 

When you enter FED, you see a complex frame of many panes. The following are 
descriptions of the panes in the FED frame: 



Drawing Pane 



Character Box 



Sample Pane 



The largest pane is the drawing pane, which contains a grid of 
dots forming an array of squares, and a box drawn in the 
middle. When you edit a character, FED draws the character in 
this pane, magnified 12 to 1. (You can choose other 
magnifications with the [Configure] and [Grid Size] FED menu 
commands.) Each box, delineated by four dots, represents one 
pixel (bit-raster dot) of the character being edited. 

The basic technique of editing characters is to draw lines, 
points, and curves on this pane, using the mouse as a graphic 
input device, and thus modify the bit-raster definition of the 
character being edited. Mouse clicks on the drawing pane draw 
and clear points. For information on mouse use on the drawing 
pane: See the section "Drawing in FED", page 299. 

The box drawn in the center of the drawing pane is called the 
character box. It shows the font baseline and character height, 
as well as the width and kerning of the character being edited. 
The box itself shows the right and left margins of the character, 
and the top and baseline of the font. The line under the 
character box shows the character height of the font, which is 
the height that the window system uses to compute line spacing 
for windows with the current font in their font map. It 
represents, in essence, the maximum height of any character in 
the font, although it is a font parameter, not one computed by 
inspecting all characters in a font. 

You can alter the positioning of the character box, as well the 
character width it represents. See the section "Viewing and 
Altering a Character in the FED Character Box", page 301. 

The topmost pane of the FED frame is called the sample pane. 
It shows what the character being edited looks like in normal 
size. That display appears in the leftmost part of the sample 
pane. About an inch to the right of that, the sample pane 
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shows a life-size sample string in the font being edited. (You 
can set this sample string with the [Set Sample] FED menu 
command.) The sample string allows you to see what a given 
word or phrase, drawn in the font being edited, looks like. This 
allows you to see your changes to a given character in context. 
Note that the sample pane changes size as you select fonts of 
differing character height. 

Prompt Pane Between the sample pane and the drawing pane is the prompt 

pane. This is used whenever keyboard t3T)ein is required. 
Occasionally, messages and instructions to you (such as how to 
use the mouse for curve and line drawing) appear there too. 

Menus To the right of the drawing pane is a set of menus and 

miscellaneous panes. 

Draw Mode Menu 

The topmost menu is called the draw mode menu; it tells the 
default interpretation of mouse clicks on the drawing pane. One 
element of the draw mode menu is always highlighted, and 
specifies the current interpretation of the mouse on the drawing 
pane. Selecting (by mouse click) any item on the draw mode 
pane makes the selected mode be the new default, and 
highlights that mode. Other ways of changing the draw mode 
also update the highlighting in this pane. See the section 
"Drawing in FED", page 299. 

Under the draw mode menu appear three command menus that 
display a repertoire of commands that you can issue at any time 
by clicking on their items with the mouse. Many of the items 
interpret the different mouse buttons differently. See the 
section "FED Command List", page 327. The mouse 
documentation line at the bottom of the screen displays the 
interpretation of the mouse buttons when the mouse is 
positioned over a potential choice. 

The three command menus are grouped by related function: 



Drawing Pane Menu 

The topmost command menu (drawing pane menu) presents a 
group of commands allowing you to control how you are looking 
at what you see, and commands to perform automatic 
transformation and drawing on the character being edited. 
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Gray Plane Menu 

The second command menu contains commands apropos the gray 
plane, which is, in effect, a second pane behind the drawing 
pane, whose display is shown in gray instead of black. You can 
use the gray plane to see two characters at once, to see one 
character as a model while editing another, and so on. The 
gray plane can be moved around and manipulated in several 
ways. See the section "The FED Gray Plane", page 303. 

Outside FED Command Menu 

The third command menu contains commands deaUng with the 
world outside FED: reading and writing files, getting help, 
leaving FED, and selecting and saving characters and fonts. 

Status Pane Under the command menus is the status pane, which tells you 

what font and what character is being edited. The character is 
displayed in the default Lisp Machine font: this is to be 
considered an identification of the character you are editing. 
For example, if you display the font zl-user:greek9 with [Show 
Font], you see that the omega character in zl-user:greek9 
occupies the position that corresponds to W in the default Lisp 
Machine font. So the status pane identifies that character as 
W, but the "real" character (omega) is displayed in the sample 
pane. The status pane also shows you the width of the 
character being edited. The width is changed by manipulating 
the vertical edges of the character box; this action updates the 
status pane's display. 

Character Select Menu 

Under the status pane is the Character Select menu, which is 
used to select a character to edit. Simply choking on an item in 
this menu (once a font has been selected) draws that character 
in magnification in the drawing pane, so you can begin editing 
it. You can also use the Character Select menu to answer any 
prompt for a character, such as those issued by the Rename 
Character and Gray Character commands. When a prompt is 
issued that can be answered by clicking on this menu, it says so 
in its text. 

Font Parameters Menu 

Under the Character Select menu is the Font Parameters menu. 
It displays the font-wide parameters, such as blinker height and 
width, and baseline and character height. This is a Choose 
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Variable Values menu; by clicking on any of the numbers in it, 
the menu "opens up" and allows you to type in a new value. 
When you change a font parameter in this way, the change 
takes effect immediately. The FED frame can even change 
shape to accommodate the new parameters. All values in this 
menu are displayed and accepted in decimal, regardless of the 
setting of zhbase and zhibase. 

Register Pane The final pane of the Fed frame is the register pane, which is 
labelled Registers. It is divided into as many little boxes 
(registers) as fit; the size of the boxes is computed from the 
parameters of the current font. Registers can be used to store 
characters and pieces of characters being edited, and retrieve 
them, without storing them into any font. See the section 
"Saving Characters and Pieces of Characters in FED Registers", 
page 307. 

FED has an alternative configuration, or pane layout, that gives a wide aspect 
ratio (screen-wide) to the drawing pane, as opposed to the normal tall aspect ratio. 
The [Configure] menu item in the top command menu can be used to switch 
configurations. When selected, it pops up a menu of the two possible 
configurations. 

Many FED commands produce typeout, text and/or drawings that are "written 
over" the whole FED frame display. [Show Font] and [List Fonts] are typical of 
such commands. When a command produces typeout, the typeout remains until 
the next command is typed. Pressing SPACE is a command that does nothing; use 
it to erase typeout and do nothing more. 



18.2 Selecting a Font 

FED edits one font at a time, and one character in that font at a time. You can 
make new fonts, and add new characters to fonts. Using FED consists of selecting 
a font, then selecting, successively, several characters in that font, editing each 
one in turn, and "storing" it back into the font. When this editing is finished, the 
font in the Lisp environment reflects all of these changes. At that time, you 
usually want to write the font out to a BFD file, to save your work. See the 
section "Reading and Writing FED Files", page 325. 

FED provides several ways to select a font. 

• You can name the font to be edited in the command or Lisp form that invoked 
FED. See the section "Entering and Leaving FED", page 289. 

• You can select the [Edit Font] menu item, which prompts for the font name in 
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the prompt pane. Use [Edit Font (M)] to copy an existing font as the first step 
of making a new font. 

You can Ust all loaded fonts with the [List Fonts] menu item. The display 
produced by [List Fonts] is mouse sensitive: moving the mouse over the name of 
any font highlights it, and clicking on it begins editing of that font. Using 
[List Fonts (R)] lists all fonts on the file computer as well as loaded ones. This 
usually takes a long time to produce. The keyboard command F can also be 
used to prompt for the name of a font to edit. 

18.2.1 Creating a New Font 

If you attempt to edit a font that is not known to the system, FED asks you 
whether you wish to create that font. This is the way you create new fonts. 
When you create a new font, the first thing you usually want to do is alter the 
font parameters (in the font parameters menu) and define the Space character, 
from which many facilities in the system (including some in FED) determine the 
"usual width" of characters in this font. As a matter of fact, you might want to 
reconfigure the FED frame after setting the width of Space, to correctly 
recalculate the width of registers in the register pane. 

18.2.2 Displaying Ciiaracters in the Font 

When you start editing a font, you are not editing any character. The drawing 
pane displays a typical character box, and no points. The specifications for the 
character box reflect the Space character in the font. You must then select a 
character to edit. FED then displays all of the characters in the font, using the 
display normally obtainable by [Show Font]. You can erase this display by 
pressing SPACE or by selecting a character to edit. See the section "Selecting a 
Character in FED", page 297. 



18.3 Selecting a Character 

Once a font has been selected, FED edits one character at a time. You modify the 
definition of the character by drawing and clearing points on the drawing plane. 
When you are done editing a character, you store it back in the font by using the 
[Save Char] menu item. Your changes to the character are not saved until you do 
this. Furthermore, none of your changes to a font being edited become permanent 
until you write the font out to a file. 
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1 8.3.1 From the Character Select Menu 

The usual way to select the character being edited is by using the mouse to select 
a character in the Character Select menu. When you select a character, it is 
drawn in magnification in the drawing pane, and the status pane is updated to tell 
you what character you are editing. 

18.3.2 By Creating a New Character 

If you attempt to edit a character that is not in the font being edited, FED creates 
a new character. This is the way new characters are created. The new character 
is not actually saved in the font until the [Save Char] command is issued. 

18.3.3 From the [Show Font] Display 

You can also select a character by displaying all of the characters of the font 
being edited, via the [Show Font] menu item. The display produced by this 
command is mouse sensitive: when you move the mouse over the image of a 
character, it is highlighted, and if you click on it, editing of that character begins. 
This display is produced automatically when you select a font to be edited. 

18.3.4 With the c Command 

The keyboard C command can also be used to select a character. Pressing C 
prompts for a character, which can be supplied from the keyboard or the 
Character Select menu. 

18.3.5 By Renaming Characters 

Another way to edit a character is to rename the character being edited to some 
other character. This is one way to move characters around in a font, and make 
characters into other characters. Selecting the [Rename Char] menu item prompts 
for a character to call the character being edited. You can answer this prompt 
either by tjrping a cheiracter from the keyboard, or from the Character Select 
menu. This changes FED's idea of what character you are editing, and the status 
pane and sample string (if any) are updated to reflect this fact. Renaming a 
character does not store it back in the font; you must do that by yourself, as 
usual, with the [Save Char] command when you are done editing it. 
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19, Drawing 



The most common technique for creating and editing characters is to draw and 
clear points on the drawing pane using the mouse. 

A nonmouse cursor can be moved around with the keyboard. Sometimes, as when 
square-counting is necessary, this is useful. See the section "The FED Nonmouse 
Cursor", page 300. 



19.1 Drawing Characters with the Mouse 

Drawing on the drawing pane is in one of three modes at any time, [Set Points], 
[Clear Points], or [Flip Points]. The highlighted item in the draw mode menu 
tells which is in effect. When you click left on a box in the drawing pane, that 
box is made black (set), or white (clear), or complemented (flip), according to the 
current draw mode. If you hold the left button down (that is, you do not release 
it after clicking left on a box) and move it aroimd, you set (or clear or 
complement) all squares over which you pass. In this way, you can draw curves 
or pictures, fill in areas, clear old mistakes, and so forth. This is the most 
common operation in FED, and is called drawing with the mouse. 

You can change the drawing mode either by selecting another draw mode by 
clicking on an item in the draw mode menu, or by clicking middle on the drawing 
pane. Clicking middle rotates through the possible draw modes. 

When you draw with the mouse, the sample pane is not updated until you release 
the left button. (You might want to do this every now and then while drawing 
with the mouse, just to observe what you have in life-size, and then press the left 
button again, to continue drawing.) 

Often, you might want to "temporarily" change the draw mode, either because the 
draw mode menu is too distant, or the mouse is not in top shape, or because you 
really want to change the draw mode for just one or two squares. You can do this 
while drawing by manipulating the CONTROL and METR keys on the keyboard. If 
you hold down CONTROL alone while drawing, the temporary draw mode becomes 
[Clear Points] for as long as it is held down. Similarly, METR alone sets up [Set 
Points] mode for as long as it is held down. CONTROL and METR together 
temporarily put the mouse in pass-over mode, in which it makes no change to any 
squares it passes over. 

Flip mode is useful for final touch-ups, a click at a time, rather than drawing with 
the mouse button down. Since it changes any square you click on, it is most 
useful when you fix up single squares in the final stages of editing a character. 
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19.2 The Nonmouse Cursor 

The nonmouse cursor is an "alternative mouse" that can be used to draw in the 
drawing pane. It can be useful when the mouse is not in top shape, or when you 
are doing some design that involves counting squares carefully. 

This cursor is normally not visible. It starts out in the upper left-hand corner of 
the drawing pane. You move it via the /, s, [, and ] keys, which tell the 
direction in which to move it. See the section "FED Menu and Keyboard 
Commands", page 327. When you start moving it, it appears as a smaller, blinking 
box inside the grid box over which it sits. When you draw with the real mouse, it 
goes away. 

The keyboard command " . " complements the box over which the nonmouse cursor 

sits. 

You can also move the nonmouse cursor in numerically specified movements using 
specialized commands. See the section "FED Command List", page 327. 
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20. Viewing and Altering a Character in the Character 
Box 



The character box is the mechanism by which you can view and alter the 
boundaries of a character being edited. The following is a description of its edges, 
and instructions for changing them. 



20.1 What the Lines Mean 

FED displays a character box in the drawing pane, to indicate the "boundaries" of 
the character being edited. These boundaries are not absolute limits outside 
which the character cannot extend; rather, they are the positions that are to be 
considered the start and end of this character when it is drawn in use. 
Characters in italic fonts and foreign scripts often extend into the "territory" of 
the previous or next character. Such "incursion" is accomplished by a character's 
containing points outside its limits. 

Left and right edges 

The left edge of the character box represents the cursor position 
at the time the character is drawn in real use. Any points to 
the left of this are in the "territory" of the previous character. 
The right edge represents the start of the next character. The 
distance between the left edge and the right edge is called the 
character width, and specifies the distance by which the window 
system increments its horizontal cursor position after drawing 
this character. Points to the right of the right edge of the 
character box are an incursion into the territory of the next 
character to the right. 

Bottom edge The bottom edge of the character box (not the line under it) 

represents the baseline of the font. The baselines of all 
characters drawn on a line, in any font, form a continuous line, 
the normal "bottom" of most characters. Points below the 
baseline are "descenders". 

Top edge The top edge of the character box represents the top of the 

character. You cannot put points above the top, but FED lets 
you draw such points, for you might move them and/or the 
character box before you save the character. FED warns and 
asks you what to do if you attempt to save a character that has 
points above its top edge; this is an error. The distance 



302 

Text Editing and Processing July 1986 



between the top edge and the baseline is fixed for any given 
font (although you can use FED to change the value of that 
number). If you are making a new font, you should carefully 
consider this parameter (the font's baseline) before generating 
any characters. 

Character height The line below the bottom of the box represents the character 
height of the font, which is the distance between the top edge 
and this line. This distance, too, is a fixed parameter for any 
font, although you can use FED to alter it for the whole font. 
You cannot put points below this line; if you do, they appear in 
the territory of the next line when drawn, and are cleared or 
overwritten inconsistently. The maximum of the character 
heights of all fonts in the font map of a window is used to 
compute the line spacing of a window. 



20.2 Altering the Character Box 

You can move the edges of the character box on the drawing pane by clicking on 
them (within one-half box on either side) with the right mouse button. Hold the 
button down and move the line to where you want it to be, and then release the 
button. 

Moving the character box redefines the orientation of the character, as drawn, 
with respect to the other characters in the same font. 

If you attempt to move the bottom edge, top edge, or character height line, you 
move them all, and thus move the whole character box vertically. You cannot 
move them individually because the distances between them are fixed parameters 
for the font. If you alter these parameters by selecting them in the Font 
Parameters menu, the character box is altered and redrawn appropriately. 

Sometimes, you want to move the whole character box without changing its shape. 
The easiest way to do this is to move the data being displayed with the [Move 
Black] menu item. See the section "Transformations on Characters in FED", page 
309. 
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21- The Gray Plane 



The gray plane is a "shadow" "behind" the drawing pane that allows you to look 
at another character in addition to the one you are editing. The character (or 
piece of a character) in the gray plane shows up in light gray in the drawing 
pane. Where bits are on in both the gray plane and the character being edited 
(the black plane), a dark gray square is shown. 

Frequently, the gray plane is used to hold a character that resembles, or has 
pieces of, the character being edited, to serve as a guide for drawing the new 
character. At other times, the gray plane is used to hold a piece of a character, 
to be merged later into the black plane. 

The second of the three command menus is a special menu for commands dealing 
with the gray plane. It is also possible to fetch previously created patterns into 
the gray plane from the register pane. See the section "Saving Characters and 
Pieces of Characters in FED Registers", page 307. 



21.1 Getting Things Into Gray 

The most common ways of putting drawings into the gray plane are to move the 
black plane into it and to fetch characters into it. The [Swap Gray] and 
[Gray Char] menu items do this. 

21.1.1 With [Swap Gray] 

[Swap Gray] exchanges the black and gray planes; what had been black becomes 
gray, and what had been gray becomes black. After you use [Swap Gray], you are 
editing in the black plane what had been in the gray plane, and what you had 
been editing in the black plane (where all editing is done) is now visible in the 
gray plane. You can clear the black plane with [Erase All]; [Clear Gray] (in the 
gray plane menu) clears the gray plane. 

You can swap the gray and black plane to bring the gray plane up for editing, to 
move something you have edited into the gray plane, or to do both at once. 

21.1.2 With [Gray Char] 

You can bring characters directly into the gray plane. Using [Gray Char] prompts 
you for a character in the current font to be brought into the gray plane. You 
can then type the character, or select it in the Character Select menu. The 
keyboard command G does this, too. The character is placed at the character box. 
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It does not really matter where the character is placed, though, because before 
merging it or using it, you can move it to any place in the gray plane by using 
[Move Gray]. See the section "Merging Characters with the FED Gray Plane", 
page 304. 

You can bring characters from other fonts into the gray plane by using 
[Gray Char (R)]. A Choose Variable Values menu is presented, offering choices 
not only of character and font, but of scaling as well. Click on values you wish to 
change; keep in mind that the [Character] item expects a single character when 
you use it. Scaling allows you to grow or shrink the character being fetched 
before bringing it into the gray plane. The numerator and denominator of the 
scale fraction are displayed and interpreted as decimal numbers. When you are 
done choosing values for [Gray Char], use [Do It] to bring in the character. 



21.2 Merging Characters with the Gray Plane 

The gray plane is the mechanism for adding pieces of characters into characters 
being built. You do this in two steps: 

1. Put a character or a piece of a character into the gray plane and position it. 
You use the [Move Gray] command to reposition a drawing in the gray plane. 
It leaves the black plane and the character box unaffected; it moves bits within 
the gray plane only. When you use it, you are asked in the prompt pane for 
two points, which you indicate by clicking left on them in the drawing pane. 
These points indicate where from and where to move the data in the gray plane. 
FED temporarily grays (in a distinguishable gray) the points you select so that 
you can see them, and then moves all the data in the gray plane so that the 
first point is moved to the second. Usually, rather than clicking random points, 
you should click a specific point in the gray drawing and the point in the black 
drawing with which you wish the gray point to coincide. You might also think 
of these points as a point in the gray plane and a point in the black plane to 
which the point in the gray plane is to be made to coincide. 

2. Merge it into the black plane. The [Add in Gray] command merges the gray 
plane into the black plane. Normally, you use [Add in Gray]. This turns on 
(makes black) each point in the black plane that is "over" a turned-on (gray) 
point in the gray plane, and leaves the gray plane as it was. Thus, the points 
that were gray now all appear in dark gray, indicating they are on in both 
planes. Using [Add in Gray (M)] is similar, but clears the gray plane 
afterwards. 

You can also merge the gray plane into the black plane by other logical operations 
than the default Inclusive Or: using [Add in Gray (R)] pops up a menu of logical 
combination operators. ANDCA (turn off all black points corresponding to "on" 
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points in the black plane, that is, punch a hole in the black plane as indicated by 
the gray plane) and XOR (flip all points in the black plane that are on in the gray 
plane) are offered, as well as the default value, lOR 
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22. Saving Characters and Pieces of Characters in 
Registers 



FED's gray plane allows you to edit one character or piece of a character. You 
can also save characters and pieces in registers. The register pane shows the 
contents of registers that can hold characters and pieces of characters for reuse. 



22.1 Saving a Drawing Into a Register 

You save a drawing (in the black plane, after editing) by clicking left on one of 
the empty registers (little boxes) in the register pane. Do not use the first (upper 
left-hand) one. Clicking left on an empty register (one that looks blank) saves the 
current black drawing in that register. Registers are mouse-sensitive, and grow a 
thick border when you move the mouse over them. Click on an empty register, 
and the drawing in the black plane appears in that register, in the register pane, 
and remains there. FED makes every effort to show you a visible piece of that 
character, so that you know it is there. 



22.2 Retrieving tiie Contents of a Register 

To retrieve a register, click left on it, and the contents of the register are 
transferred into the black plane. If you click on a register that has a drawing in 
it, that drawing goes into the black plane. If it does not have a drawing in it, the 
black plane goes into it. Thus, clicking left on registers is usually the only 
dealing you have with them. 



22.3 Retrieving the Biacl( Plane While Manipulating Registers 

You might click on a different register than the one you intended. Or perhaps a 
register is not really empty, but has a peculiar drawing in it that has a gigantic 
empty middle. In either of these cases, you might lose the very work in the black 
plane that you were trying to save. Thus, FED always copies the current black 
plane into the upper left-hand register when fetching the contents of a register, in 
case you made a mistake. You can then click on the upper left-hand register to 
retrieve its contents. 

Drawings saved in registers are saved as bits; the orientation and size of the 
character box are not saved. 
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It is possible to save the gray plane into a register, or fetch a register into the 
gray plane. It is also possible to store into a nonempty register from either plane. 
If you want to do any of these operations, click right on a register, and a menu of 
possible operations pops up. 
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23. Transformations 



Although drawing with the mouse is the most common way to create characters 
and pieces of characters, FED can provide a good deal of automatic drawing help, 
such as drawing lines and curves and performing transformations on the character 
being edited. As is true of drawing with the mouse, all of these operations are 
applicable only to the black plane. If you want to perform them on the gray 
plane, swap planes, perform them, and swap back. 



23.1 Clearing the Drawing 

The simplest operation on a drawing is getting rid of it; [Erase All] clears the 
entire (black) drawing. The gray drawing, if any, is left intact. You are queried 
to make sure you really want to clear the entire drawing. This function is also 
accessible via the keyboard command E. 



23.2 Rotating Drawings 

FED can rotate characters 90 degrees right or left, or 180 degrees. Rotations are 
performed about the center of the square whose top, right, and left edges are the 
top, right and left edges of the character box, and thus, whose bottom must be, 
and is, a distance below the top of the character box equal to the character width. 

Rotation Mouse command 

90 degrees right [Rotate (R)] 

90 degrees left [Rotate] 

180 degrees [Rotate (M)] 

Note that rotating the drawing 180 degrees is not the same as turning it upside 
down. 



23.3 Reflecting Drawings 

FED can reflect drawings about any of four lines. Using [Reflect] pops up a menu 
of the four lines about which to rotate the drawing. Those lines all pass through 
the "center" of the character box, the point halfway between the left and right 
edges and halfway between the top and the bottom line, not the baseline. 
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These lines are the horizontal and vertical lines through the center point, the 

X Axis (I) and the Y Axis (-), and the 45-degree diagonals, the line X=Y (/), and the 

Une X= -Y (\), through it. 

Reflection is subtle; it is very different than rotation. Imagine the drawing as 
made of sheet metal, lying on the plane. Rotation moves the character around in 
the plane, turning it, but never lifting it off the plane. Reflection picks it up, and 
puts it back, face down on the plane. The effects of diagonal reflections are 
subtle. The best way to understand these commands is to edit an asymmetrical 
but simple character (the one of choice is F) in a straightforward font (for 
example, HL12B), and try these various reflections upon it, as well as the 
rotations. 



23.4 Moving the Drawing 

You can move the drawing around with [Move Black]. [Move Black] moves the 
drawing with respect to the character box, the drawing pane itself, and the gray 
plane. [Move Black] prompts for two points, a point in the black plane and a 
point to which to move it. The whole black drawing moves along with it as well. 



23.5 Drawing Lines and Curves 

FED can draw approximate lines and curves in the drawing. Rather than drawing 
actual lines and curves on the drawing, FED manipulates squares along the line or 
curve desired. Thus, if you ask to draw a line that is not straight up, down, or 
across, FED approximates as well as it can. 

To draw a line, use [Draw Line], and select two points between which to draw a 
line. As with all commands in which FED prompts for points, the points are 
temporarily grayed when you click on them, to verify your choices. The line is 
drawn in the current draw mode, which means it clears a line if appropriate, or 
even flips all the points along one (which is hardly ever appropriate). 

To draw a curve, use [Draw Spline], Then click left on all the points through 
which the curve is to pass. When you are done, use [Draw Spline (R)]. The 
spline-drawing package is called to compute the points of an unconstrained cubic 
spline through these points, and the approximate curve is drawn in the current 
draw mode. See the section "Drawing Splines on Windows" in Programming the 
User Interface, Volume B. 
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Figure 6. [Reflect] 
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Figure 7. The X axis (-) 
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23.6 Stretching and Contracting 

FED can stretch or contract drawings. This is not the same as growing or 
shrinking them. Stretching means inserting duphcate rows or columns at a given 
point of the drawing, and contracting means removing rows or columns. Growing 
and shrinking, in general, mean scaling the whole drawing up or down. The latter 
is done with the options to [Gray Char]. See the section "Getting Things Into the 
FED Gray Plane", page 303. 

The relative orientation of the first and second points clicked on specifies whether 
you want to stretch or to contract. 

23.6.1 Stretching a Drawing Horizontally 

Stretching a drawing horizontally means making some number of copies of a 
column of squares to the right of that column. To stretch a character 
horizontally, use [Stretch], and then click left on any square in the column to be 
"stretched". Then click left on any square in the column to the right of that to 
which that column is to be stretched (that is, the last column to be a duplicate of 
the column being stretched). The entire drawing is stretched, with the required 
number of copies of the duplicated column inserted. 

23.6.2 Contracting a Drawing Horizontally 

Contracting a drawing horizontally means eliminating some number of columns of 
squares. To shrink a character horizontally, use [Stretch]. Then click left on any 
square in the rightmost column not to be eliminated, at the right edge of the 
columns to go, and then on the leftmost column to be eliminated. You should 
think of this as clicking on a column to move, and where to move it to. 

23.6.3 Stretching a Drawing Vertically 

Stretching a drawing vertically means making some number of copies of a row of 
squares below that row. To stretch a character vertically, use [Stretch (.M)}, and 
then click left on any square in the row to be "stretched". Then click left on any 
square in the row below that to which that row is to be stretched (that is, the last 
row to be a duplicate of the row being stretched). The entire drawing is stretched, 
with the required number of copies of the duplicated row inserted. 

23.6.4 Contracting a Drawing Vertically 

Contracting a drawing vertically means eliminating some number of rows of 
squares. To shrink a character vertically, use [Stretch (M)]. Then click left on 
any square in the topmost row not to be eliminated, at the top edge of the rows to 
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Figure 10. Contracting Horizontally 
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go, and then on the topmost row to be eliminated. You should think of this as 
clicking on a row to move, and where to move it to. 
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24. The Sample String 



When you edit a font, it is usually convenient to maintain a sample string, 
displayed in the font, so that you can see how the character you are editing looks 
in the context of other characters next to which it might appear. 

FED allows you to set a sample string. The straightforward method of setting it 
is to select the [Set Sample] menu item: doing so prompts you for the string, 
which should be short enough to fit in the sample pane (it is clear if it does not, 
as you only see the end of it). End the string by pressing RETURN. The string is 
then displayed in the sample pane. 

If the sample string contains the character being edited, occurrences of that 
character are updated whenever any change is made to the drawing. Thus, the 
occurrences of the character being edited in the sample string reflect the state of 
the current drawing, not the state of that character stored in the font. 

Two other ways to ask FED to prompt you for the sample string are clicking any 
button on the sample pane itself, and issuing the U command from the keyboard. 
This last is often the most convenient, because you are then going to type the 
string itself 
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25. Adjusting the Display 



The commands and facilities described here deal with positioning the drawing 
display and modifying its visible characteristics. They do not actually change the 
data in the drawing, but rather, the way it is viewed. 



25.1 Positioning the Drawing 



Both the black and gray drawings can be thought of as being drawn on an infinite 
plane. The character box is in the center of that plane. Although [Move Black] 
and [Move Gray] exist to move the drawings, and the character box can be moved 
by clicking on it, sometimes you might want to reposition the entire drawing, 
character box, black drawing, gray drawing, and all. This can also be viewed as 
repositioning the view of the drawing offered by the drawing pane. FED provides 
several techniques for repositioning the entire drawing. 



[Move View] 



[Center View] 



Scrolling 



The simplest is [Move View]. [Move View] works just like 
[Move Gray] and [Move Black]. When you use [Move View], it 
prompts you for two points, which you indicate by clicking left 
on squares on the drawing pane. The first point is a point on 
the drawing; the second is a point in the pane to which to move 
it. The whole drawing is moved, perhaps simultaneously 
vertically and horizontally, so that the first point is where the 
second point had been. 

Another common need is to recenter the drawing, that is, put 
the character box back in the middle. This is the way the 
drawing pane starts out when you begin editing a character. 
The [Center View] menu item performs this task. Use [Center 
View] to recenter the drawing. The keyboard H (for Home) 
command does this too. 

Another way to reposition the display is to scroll it up or down 
or left or right. In order to scroll the display vertically, a scroll 
bar is provided at the left of the drawing pane. When you move 
the cursor to the extreme left edge of the drawing pane and 
bounce the cursor at that edge, the cursor changes to a double- 
pointed arrow and the left margin of the drawing pane displays 
a graph of the vertical portion of the drawing you are looking 
at. The status line documentation reflects the possible options 
at this point. 
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To scroll the drawing horizontally, a scroll bar is provided at 
the bottom of the drawing pane. When you move the cursor to 
the extreme bottom edge of the drawing pane and bounce the 
cursor at that edge, the cursor changes to a double-pointed 
arrow and the bottom edge of the drawing pane displays a full- 
grid length graph of what horizontal portion of the drawing you 
are looking at. The status line documentation reflects the 
possible options at this point. 



25.2 Setting the Box Size in the Drawing Pane 

You can set the size of boxes in the drawing pane. Normally, it is 12, meaning 
each box, corresponding to one pixel of the actual character, is represented by a 
box 12 pixels wide and high. To set the size of boxes, use [Grid Size]. FED 
prompts you for the size of a box, in decimal. This size can not be bigger than 64 
pixels. If you tyjie a carriage return without typing any number, the default size 
of 12 pixels is reestablished. 



25.3 Setting the Height and Width of the Drawing Pane 

You can tell the FED frame to show either a wide drawing pane, as wide as the 
screen, or a tall drawing pane, almost as tall as the screen. These two 
configurations of the frame are chosen from a pop-up menu that is obtained by 
using [Configure]. This command can also be used to have FED recompute its 
configuration, for example, to reshape its registers after you have edited the Space 
character of a font. 
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26. Reading and Writing Files 



FED can read and write files containing fonts in any of a variety of formats. The 
most common format is BFD, the standard font format of the Symbolics Lisp 
Machine. If you are making fonts for use by the Symbolics Lisp Machine display 
and window system or the LGP-1, this is the only format you should ever have to 
deal with. 

Most of the other formats are for compatibility with other systems and earlier 
releases of the S3mibolics Lisp Machine software. Notable among these formats is 
PXL format, which is a standard font format with the TEX system on UNIX. 
BFD format is the default for all file reading and writing operations. 



26.1 Reading Files 

Use [Read File] and type in the file name to read in a font file. The file type 
defaults from the (canonical) tj^De of the pathname presented as the default. For 
example, if you type fix9.bfd, or just fix9, you read a BFD file, whereas if you 
type fix9.bin, you read a BIN file. FED complains if you supply a file type that 
is not a valid font file type for the machine you are using. Pressing R is 
equivalent to using [Read File]. 

From outside of FED you can use Dired to read in any font file. Enter Dired, 
move point to the line showing the font file, and press fl (which queues a file to 
be acted on by a function). Apply the zl:fed function to that file to read it in. 

When you read in a font via [Read File], it is actually loaded. It becomes part of 
the Lisp environment, and appears in listings of loaded fonts produced by [List 
Fonts] as well as by the Show Font command and by Zmacs. After FED loads the 
file and looks for the font you specified, you are editing that font. 

It is sometimes necessary to read in font files of exotic types, whose file types (as 
expressed in the name of the file) are not indicative of the format of the font. 
For instance, you might have renamed a BFD or other file to myfont.temp, and 
now you want to read it in. Since FED cannot determine the font format from 
this file t3^e, you must specify the font format explicitly. This is done by using 
[Read File (R)]: FED offers a menu specif3dng file types. Click on the file type 
involved: FED then prompts for a pathname and reads the file. FED interprets 
the file, however, according to the format specified by the menu, not by the file 
type. 
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26.2 Writing Files 

FED can also write out font files. Files are written from the description of a font 
residing in the Lisp environment, not from any temporary FED image of the font. 
Since FED maintains no temporary image of the font, but actually stores edited 
characters back in the font when you use [Save Char], this is not a problem unless 
you forget to save your characters. 

Use [Write File] to write the font file out. The file type defaults from the 
(canonical) type of the pathname presented as the default. For example, if you 
type newfnt.bfd, you write a BFD file, whereas if you type newfnt.bin, you write a 
BIN file. FED complains if you supply a file type that is not a valid font file type 
for the machine you are using. Using [Write File] writes out a BFD file by 
default from a font description in the Symbolics Lisp Machine virtual memory. 
The default directory is the system screen fonts directory; the default file name is 
font.hfd, where font is the current font being edited. Pressing W is equivalent to 
using [Write File]. 

It is sometimes necessary to write out font files of exotic tj^Des, whose file tj^jes 
(as expressed in the name of the file) are not indicative of the format of the font. 
For instance, you might already have a sfnt.bfd, and want to write your file to 
sfnt.temp. Since FED cannot determine the font format from this file type, you 
must specify the font format explicitly. This is done by using [Write File (R)]: 
FED offers a menu specifying file t3T)es. Click on the file type involved: FED 
then prompts for a pathname and writes the file. FED writes the file, however, 
according to the format specified by the menu, not by the file type. 
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27. Command List 



The following is a listing of all FED commands. The first part of this listing 
describes the commands available via the command menus and the keyboard. 
When a keyboard character exists duplicating a menu command, it is given in 
addition after the command name. The second part of this section describes the 
effect of clicking on various panes and mouse-sensitive areas of the FED frame. 

Many of the keyboard commands take numeric arguments to specify some number 
or character. Numeric arguments are entered by typing a decimal number before 
the command character. The numeric argument is echoed in the prompt window 
as you enter it. 



27,1 Menu and Keyboard Commands 



27.1.1 Configuration and Drawing Transformation 



[Configure] 
[Grid Size] @ 

[Center View] H 
[Move View] 

[Draw Line] 

[Draw Spline] 



[Erase All] E 
[Stretch] K 



Pop up a menu of frame configurations. Two configurations are 
offered, giving a tall and wide aspect ratio to the drawing pane. 

Set the size of boxes in the draw pane. If a numeric argument 
is given, it is used as the size. @ sets grid size to the default if 
given no numeric argument, but [Grid Size] prompts. 

Reposition the display in the drawing pane so that the character 
box is centered in it. 

Reposition the display in the drawing pane by prompting for two 
mouse-specified points: which point to move and to which point 
to move it. 

Draw a line in squares in the drawing pane, in the current 
drawing mode. Prompt for two endpoints, to be specified with 
the mouse. 

Draw a cubic spline in squares in the drawing pane, in the 
current drawing mode. Prompt for curve points, to be specified 
by using [Draw Spline]. Using [Draw Spline (R)] ends the 
curve. 

Clear all points (black points) in the current drawing. 

Stretch or contract a character, horizontally or vertically. 
[Stretch] is horizontally, [Stretch (R)] is vertically. FED 
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prompts for two points, specifying a row or column to move and 
to where to move it. From the keyboard, K means horizontal, 
c-K means vertical. See the section "Stretching and Contracting 
Drawings in FED", page 316. 

[Rotate] © Rotate the drawing in the black plane. [Rotate] is 90 degrees to 

the left, [Rotate (R)] 90 degrees to the right, and [Rotate (M)] 
180 degrees. 

[Reflect] <-> Reflect the drawing in the black plane about a coordinate axis 

or diagonal line through the center of the character box. A 
menu pops up, asking which. 

[Move Black] Move the drawing in the black plane. You are prompted for the 

target and destination points, which you specify by clicking left 
on the drawing pane. 



27.1 .2 Gray Plane Menu items 

[Gray Char] G, also M 

Place a character into the gray plane. The keyboard commands 
accept numeric arguments to specify which character. If none 
is given, or if you use [Gray Char], you are prompted for a 
character, which you can supply from the keyboard or the 
Character Select menu. If you use [Gray Char (R)], you are 
offered a Choose Variable Values choice window to select the 
character, font, and scaling. For the keyboard commands, 
CONTROL causes FED to prompt for a font name, and METR 
causes it to prompt for scale factors. 



[Clear Gray] 
[Swap Gray] 
[Move Gray] 



[Add in Gray] 



Clear the entire gray plane. 

Exchange the drawings in the gray and black planes. 

Move the drawing in the gray plane. You are prompted for two 
points, to be specified via the mouse, a point to move and a 
point to which to move it. 

Combine the drawing in the gray plane into the black plane. 
Using [Add in Gray] inclusive-or's the gray drawing into the 
black drawing. Using [Add in Gray (M)] inclusive-or's the gray 
drawing into the black drawing, and clears the gray drawing. 
[Add in Gray (R)] pops up a menu of other combination modes. 
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27.1.3 Outside World Interface Menu Items 



[Edit Font] F 



[List Fonts] 



[Save Char] S 



Pick a font to edit. You are prompted for the font name. Use 
[Edit Font (M)] to copy an existing font as the first step of 
making a new font. 

[List Fonts] lists all of the loaded fonts. [List Fonts (R)] lists 
all of the loaded fonts and fonts on the file computer. The 
display is mouse- sensitive; clicking left on any item begins 
editing that font. 

Store the character being edited back into the font in the Lisp 
environment. It is stored as the character that the status pane 
indicates it to be. 



[Rename Char] c-C 

Rename the current character; make it seem as though you are 
now editing a different character, but retain the drawing. You 
are prompted for the character, which you can supply from 
either the keyboard or the Character Select menu. The 
keyboard command accepts a numeric argument to specify the 
character. 



[Show Font] D 

[Set Sample] \} 
[Read File] R 



[Write File] W 



[EXIT] Q 



Display all characters in the font being edited. The display is 
mouse-sensitive, and clicking left on a character begins editing 
that character. 

Prompt for the sample string to be displayed in the font being 
edited in the sample pane, and set it. 

Read in a file of font definitions. Prompts for a pathname. 
[Read File] computes the font file type from the file type of the 
pathname given. The default is always BFD. [Read File (R)] 
pops up a menu that offers the file types: BFD, KST, BIN, AC, 
AL, PXL, or Any. The file specified by the pathname given will 
be interpreted according to that format, regardless of file type. 

Writes a file of font definitions. Prompts for a pathname. 
[Write File] computes the font file type from the file type of the 
pathname given. The default is always BFD. [Write File (R)] 
pops up a menu that offers the file types: BFD, KST, BIN, AC, 
AL, PXL, or Any. The file specified by the pathname given will 
be written in that format, regardless of file type. 

Bury the Font Editor, and return to whatever you were doing 
when you last invoked FED. 



[HELP] HELP or ? 



Display a long message giving documentation of FED. 
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27 A A Evaluating Forms From FED 

FED uses the ESCAPE key to evaluate a Lisp form. 

27.2 Keyboard-only Commands 

The following commands are accessible only from the keyboard. They are mainly 
concerned with the nonmouse cursor, or general interaction with the subsystem. 

s Turn the nonmouse cursor on, and move it one position up the 

screen. A numeric argument tells to move it other than one 
position, c-s and n-s mean 2 and 4 positions, respectively, and 
c-m-s means 8. 

/ Same as ^, but moves the nonmouse cursor down. 

[ Same as s, but moves the nonmouse cursor left. 

] Same as n, but moves the nonmouse cursor right. 

When the nonmouse cursor is on, complement the black square 
under it. 

REFRESH Redraw the drawing pane. Useful in case of perceived problems. 

c-REFRESH Clear the screen and refresh all panes in the FED frame. 

RBORT Abort any command while it is prompting, waiting for either 

mouse or keyboard input. 

C Begin editing a character: prompt for the character, and begin 

editing it. Normally, you simply select a character from the 
Character Select menu or the [Show Font] display. C accepts a 
character specification as a numeric argument. 

27.3 Mouse Sensitivities 

This section describes the result of clicking the mouse on various portions of the 
FED frame other than the command menus. 

27.3.1 The Drawing Pane 



Click left 



Draw a black square in the current draw mode, which is shown 
by the Draw Mode menu. It continues drawing as the mouse is 
moved as long as the left button is held down. Pressing 
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CONTROL while drawing means temporarily go into [Clear Points] 
mode (METR means [Set Points] mode); neither changes any 
points. 

Click middle Change the draw mode, cycling through the three possible draw 

modes. 

Click right Only meaningful when the mouse is over a boundary of the 

character box. "Pick it up" and begin moving it as the mouse 
is moved, as the right button is held down. 

The drawing pane has a scroll bar at its left edge. 

27.3.2 The Draw Mode Menu 

Clicking any button on one of the draw modes selects that draw mode until it is 
next changed by clicking on this menu, or clicking middle on the drawing pane. 

27.3.3 The Sample Pane 

Clicking any button on the sample pane prompts for a new sample string. 

27.3.4 The Character Select Pane 

Clicking left on any character in the character select pane begins editing it. The 
character select pane can also be used to answer any command that is prompting 
for a character. 

27.3.5 The Font Parameters Menu 

Clicking left on any item in the Font Parameters menu opens it for editing. You 
are expected to type a new decimal number. As soon as you press RETURN, the 
altered parameter is stored in the font in the Lisp environment. 

27.3.6 The Register Pane 

Click left On an empty register, store the current black plane drawing in 

that register. On a nonempty register, retrieve the drawing in 
it into the black plane, and store the current black plane 
drawing into the upper-leftmost register. 

Click right Pop up a menu allowing the register you clicked on to be loaded 

from either plane (regardless of whether or not it is empty) or 
retrieved to either plane. 
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27.3.7 The List Fonts and Show Font Displays 

These displays are mouse-sensitive. Clicking left on a font in the [List Fonts] 
display begins editing it; clicking left on a character in the [Show Font] display 
begins editing that character. 
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V I I 

■ ■ ■ 

! Dired command 172 
Exclamation point (!) line continuation indicator 25, 64 

# # # 

@ # text formatting command 39 

$ $ $ 

$ Dired command 1 71 
c-X ) Zmacs command 257 



*Function-Specs-to-Edit-/7 * buffer 13 

*Function-Specs-to-Edit-n* buffer 13 
@ * text formatting command 39 



+ + + 

+ flag in Zmacs 131 



, Dired command 168 



. Font Editor drawing command 300 
@ . text formatting command 39 



/ / 

/ Font Editor command 330 



1 1 

c-X 1 Zmacs command 147 
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2 2 2 

c-X 2 Zmacs command 146 

3 3 3 

C-X 3 Zmacs command 146 



4 4 4 

c-X 4 Zmacs command 146 

8 8 8 

C-X 8 Zmacs command 1 46 



c-X ; Zmacs command 227 



= Dired command 1 69 
c-X = Zmacs command 54 
@ = text formatting command 39 



> 

@ > text formatting command 39 



? Dired command 1 67 
? Font Editor command 329 
HELP ? Zmacs command 14 

@ @ @ 

@ Font Editor command 327 
@ text formatting command 39 
c-m- @ Zmacs command 106 
m- @ Zmacs command 106 

@# text formatting command 39 

@* text formatting command 39 

@. text formatting command 39 

@= text formatting command 39 

@> text formatting command 39 

@blankspace text formatting command 39 

@b text environment 36 

©caption text formatting command 39 

@c text environment 36 

@foot text formatting command 39 

@g text environment 36 

@i text environment 36 

@note text formatting command 39 
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@p text environment 36 

@r text environment 36 

@tabclear text formatting command 39 

@tabdivide text formatting command 39 

@tabset text formatting command 39 

@t text environment 36 

@\ text formatting command 39 

@'^ text formatting command 39 



Example of a Search String for HELP 

c-X 

HELP 

c-X c-A Add Mode Word 

c-X pi US-SIGN Add Giobal Word 

Mal<e Word 

Word 

Read Word 

Write Word 

Word 

Using Word 

Word 

Word 

Edit Word 

Insert Word 

Kill Ail Word 

List Some Word 

List Word 

Word 

Dired 



Getting Information 

Warnings 

Zmacs Commands for Finding Out 

Zmacs Commands for Finding Out 

Send mail 

Zmacs Commands for Finding Out 

Zmacs Commands for Finding Out 

Finding Out 

IVIore HELP Commands for Finding Out 

Overview of Finding Out 

Finding Out 

Finding Out 

Zmacs Speller 

Zmacs Speller 



c-X plus-SIGN 



c-X c-A 



A 53 

A Dired command 172 

A Zmacs command 1 41 

A Zmacs command 1 4, 53 

Abbrev 200 

Abbrev 200 

Abbrev 202 

abbrev 198 

Abbrev File 202 

Abbrev File 203 

Abbreviation Commands 200 

Abbreviations 198 

Abbreviations 197 

Abbrev Mode 203 

Abbrevs 201 

Abbrevs 201 

Abbrevs 201 

Abbrevs 202 

Abbrevs 202 

abbrevs 198 

Abort 167 

ABORT Dired command 167 

ABORT Font Editor command 330 

ABORT Zmacs command 48 

Abort At Top Level 48 

Abort Patch (m-X) 248 

About Buffers and Regions 61 

about file attribute lists 1 56 

About Flavors 281 

About Lisp 280 

about patch 247 

About the State of Buffers 278 

About the State of Zmacs 279 

About Zmacs Commands 51 

About Zmacs Commands 53 

About Zmacs Commands 51 

About Zmacs Commands with HELP 51 

About Zmacs Variables 269 

Accept command 181 

Accept Once command 181 

Accidental deletion 49 

Active patches 242, 246 

Add Global Word Abbrev 200 

[Add in Gray] Font Editor menu item 304, 328 

Adding Site-specific Speller Dictionaries 1 89 

Adding User-specific Speller Dictionaries 188 

Add Mode Word Abbrev 200 

Add Patch Changed Definitions (m-X) 245 

Add Patch Changed Definitions of Buffer (m-X) 245 

Add Patch (m-X) 244 
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zwei: 

m-X 



Undo 

Save 

[Erase 

Clear 

m-X Save 

Kill 

Motion 

Viewing and 



Fast Where 

Where 

Motion 

Moving the Drawing Horizontally 

Scrolling the Drawing Horizontally 

Copying a File Into 

Examples of Copying a File Into 

Inserting a Buffer Into 



Dired 

Searching for 

Method for Searching for 

Searching for 

m-X 
Variable 

Variable 

Applying 

Echo 

Zmacs Echo 

Echo 

Quadruple Numeric 

Quick 



Display 

Defaults to Numeric 

Echoing 

Example of Numeric 

Numeric 

Overview of Numeric 

Negative Numeric 

Numeric 

Example of Negative Numeric 

Example of Numeric 

Positioning the Window 

Moving 



Add region to patch file 242 

add-words-to-spell-dlctionary function 1 94 

Add Word to Spell Dictionary 192 

Adjusting the FED Display 323 

Aligning Indentation In Zmacs 220 

all changes to buffer 138 

All Files (m-X) 136 

All] Font Editor menu item 303, 309, 327 

all points 327 

All Spell Dictionaries 192 

All Word Abbrevs 201 

Along One Nesting Level 76 

Altering a Character in the FED Character Box 301 

Altering the FED Character Box 302 

Alternative configuration 291 

Ami 54 

Ami 54 

Among Top-Level Expressions 77 

and/or Vertically in FED 323 

and/or Vertically in FED 323 

Another 151 

Another 152 

Another Buffer 141 

Any Extended Command 7 

Appending a Region to a Buffer 1 41 

AjDpending a Region to a File 141 

Ajspending, Prepending, and Inserting Text in 

Zmacs 141 
Append Next Kill 89 
Append To Buffer 1 41 
Append To File (m-X) Zmacs command 141 
Apply Function 1 72 

Applying Arbitrary Functions to Files in Dired 1 72 
Appropriate Commands 53 
Appropriate Zmacs Commands 53 
Appropriate Zmacs Commands 52 
Apropos 14 
Apropos 53 
Apropos 269 
Apropos (m-X) 52 
Apropos Zmacs command 269 
Arbitrary Functions to Files in Dired 1 72 
Area 20 
Area 20 

Area's Minibuffer 20 
Arg 26 
Arglist 55 
Arglist(m-X) 55 

Arglist (m-X) Zmacs command 55 
argument list 55 
Arguments 26 
arguments 26 
Arguments 26 
arguments 24, 26, 52 
Arguments 26 

Arguments and Motion Commands 71 
Arguments and the Motion Commands 71 
Arguments with Motion Commands 71 
Arguments with Motion Commands 71 
Around a Definition 66 
Around in Dired 168 
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Backspace 

Backspace file 

Base 

Base file 

Baseline Font 

Character Height Font 

Character Width Font 

Chars-exist-tahle Font 

Fixed-width Font 

Fonts 

Left Kern Font 

Lowercase 

Lowercase file 

Nofill 

Nofill file 

Patch-File 

Patch-File file 

Syntax 

Tab-Width 

Tab-Width file 

Unknown 

Vsp 

Vsp file 

File 

Buffer and File 

Describe 

Reparse 

Update 

Update 

Warnings about file 

Example of 

Blinker Width and Blinker Height Font 

Buffer 

Character 

File 

Font 

Other Set Commands for File and Buffer 

Set commands for file and buffer 

Setting Buffer 

Viewing File 

Buffer and File 

Init File Form: 
Example of Filling Text with 

Overview of Locating and Replacing Strings 
Locating and Replacing Stririgs 



Assign key bindings 267 
Associating a File with a Buffer 139 
Association of buffers with files 32 
Association of files with buffers 32 
Atom Query Replace 121 



Attri 
attr 
attri 
attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
attri 
Attri 
attri 
Attri 
attri 
attri 
Attri 
attri 
attri 
Attr 
attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
Attri 
attri 
Attr 
Attr 
Attri 
Attri 
attr 
attri 
attri 
attri 
Attri 
attri 
Attri 
Attri 
Attri 
Attri 



bute 159 
bute 159 
bute 157,160 
bute 160 
bute 286 
bute 285 
bute 286 
bute 287 
bute 287 
bute 160 
bute 286 
bute 160 
bute 160 

160 

160 

161 

161 

157 



bute 

bute 

bute 

bute 

bute 

bute 161 

bute 161 

bute 156 

bute 161 

bute 161 

bute Checking 1 56 

bute Descriptions 1 59 

bute list 155 

buteUst 168 

bute List (m-X) Zmacs command 155 

bute List (m-X) Zmacs command 156 

bute Ust Query 159 

bute lists 1 56 

bute lists 1 56 

bute-Manipulating Commands 155 

bute-Manipulating Commands 156 

butes 155 

butes 287 

butes 155 

butes 285 

butes 155 

butes 285 

butes 159 

butes 159 

butes 159 

butes in Dired 1 68 

butes in Zmacs 155 

butes of TV Fonts 285 
Auto Fill in Text Mode 274 
Auto Fill Minor Mode 253 
Auto Fill Mode 160,254 
Automatically 118 
Automatically in Zmacs 118 
Automatic drawing help 309 
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B 



B 



B 





B Font Editor command 323 


c-X 


B Zmacs command 32, 33, 133 


Getting Text 


Back 49 


Finding Files That Have Not Been 


Backed up in Dired 172 




Backspace Attribute 159 




Backspace file attribute 159 


Set 


Backspace (m-X) Zmacs command 159 


Going 


Back to First Indented Character in Zmacs 219 


File 


backup flag 172 




Backward 28 




Backward Character 72 




Backward Kill Sentence 30 




Backward Kill Sexp 30,93 




Backward Kill Word 30, 92 




Backward List 76 


Deleting 


Backward on the Line 96 




Backward Page 80 




Backward Paragraph 28,79 




Backward Sentence 28, 73 




Backward Sexp 76 


Erase 


backward to start of line 96 




Backward up List 77 


Kill 


Backward Up List (c-m-X) Zmacs command 93 




Backward Word 28, 72 


Scroll 


bar 323 




Base 156 




Base and Syntax Defaults 157 




Base and Syntax Default Settings for Lisp 33, 137, 




176,224 




Base attribute 1 57, 1 60 




Base file attribute 160 




Baseline 286,302 




Baseline Font Attribute 286 


Set 


Base (m-X) Zmacs command 1 60 


Font 


Basic Concepts 285 


Font Editor 


Basic Concepts 291 




Basic Text Formatting Commands 39 




Basic Text Formatting Environments 36 


Finding Files That Have Not 


Been Backed up in Dired 1 72 




Beep 48 


Goto 


Beginning 28, 81 


Mark 


Beginning 107 




Beginning/End of Buffer 81 


Marking a Region From Here to 


Beginning of Buffer 107 




Beginning of Definition 78 




Beginning of Line 28, 74, 95 


Move cursor to 


beginning of line 66 


Protecting Files From 


Being Deleted In Dired 171 


Protecting Files From 


Being Reaped in Dired 171 


Query Replace LET 


Binding 121 


Assign key 


bindings 267 


Definition of Key 


Bindings 267 


Extended command key 


bindings 54 


Zmacs Key 


Bindings 267 


Setting Key 


Bindings in Init Files 274 


How Key 


Bindings Work: the Comtab 267 


[Move 


Black] Font Editor menu item 302, 327 




Black pane 303 


Retrieving the 


Black Plane While Manipulating FED Registers 307 


Deleting 


Blank Line in Zmacs 221 
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Inserting 

Delete 

@ 

Blinker Width and 



Zmacs 
Using Two Windows, Select 

Altering the FED Character 

Bottom Edge of the FED Character 

Character 

Character Height of the FED Character 

FED Character 

Left and Right Edges of the FED Character 

Top Edge of the FED Character 

Using the mouse on the character 

Viewing and Altering a Character in the FED Character 

What the Lines Mean in the FED Character 

Size of 
Setting the 

*Functi on-Specs-to-Edi t-n« 

Appending a Region to a 

Append To 

Associating a File with a 

Beginning/End of 

Creating a 

Creating a Fundamental Mode 

Current 

Current Zmacs 

Editor Window's 

Encrypting and Decrypting the 

Evaluate and Replace Into 

Execute Command Into 

Format 

Hardcopying the 

Inserting a Buffer Into Another 

Inserting a File Into a 

Inserting Command Output Into the 

Inserting output into the 

Insert text from register into 

m-X Spell 

Marking a Region From Here to Beginning of 

Marking a Region From Here to End of 

Mode Line's 

Motion with Respect to the Whole 

Moving to end of 

Reading a File Into a New 

Reading a File Into an Existing 

Renaming the 

Re-reading a File Into the 

Select 

Select Default Previous 

Selected 

Select Previous 

Showing a 

The Editor Window and the 

Undo ail changes to 



Blank Line in Zmacs 221 

Blank Lines 30 

blankspace text formatting command 39 

Blinker height 287 

Blinker Height Font Attributes 287 

Blinker width 287 

Blinker Width and Blinker Height Font Attributes 287 

Boldface text environment 36 

BolioMode 177 

Bottom 146 

Bottom Edge of the FED Character Box 301 

Box 302 

Box 301 

box 291,301.302 

Box 302 

Box 291 

Box 301 

Box 301 

box 302 

Box 301 

Box 301 

boxes in the drawing pane 324, 327 

Box Size in the FED Drawing Pane 324 

Breaking a line 24 

buffer 13 

Buffer 141 

Buffer 141 

Buffer 139 

Buffer 81 

Buffer 32, 33 

Buffer 139 

buffer 137 

Buffer 132 

Buffer 18 

Buffer 137 

Buffer 120 

Buffer 136 

Buffer 42 

Buffer 136 

Buffer 141 

Buffer 141 

Buffer 136 

buffer 136 

buffer 105 

Buffer 180, 185 

Buffer 107 

Buffer 107 

Buffer 21 

Buffer 81 

buffer 81 

Buffer 137 

Buffer 137 

Buffer 136 

Buffer 138 

Buffer 32, 133 

Buffer 133 

buffer 132 

Buffer 133 

Buffer 135 

Buffer 64 

buffer 138 
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View 


Buffer 135 




Buffer and File Attribute Descriptions 1 59 




Buffer and File Attributes in Zmacs 155 


Zmacs 


Buffer and File Names 130 




Buffer attributes 155 


Other Set Commands for File and 


Buffer Attributes 159 


Set commands for fiie and 


buffer attributes 159 


Setting 


Buffer Attributes 159 


Zmacs 


Buffer Commands 133 


Writing tlie 


Buffer Contents to a File 138 


Saving the 


Buffer Contents to the File 138 




Buffer Contents with c-X c-F 33 




Buffer Flags for Existing Files 130 




Buffer Flags for New Files 131 




Buffer History 132 


Zmacs 


Buffer History 132 


Inserting a 


Buffer Into Another Buffer 141 


Init File Form: Ordering 


Buffer Lists 272 


Add Patch Changed Definitions of 


Buffer (m-X) 245 


Evaluate 


Buffer (m-X) Zmacs command 230 


Evaluate and Replace Into 


Buffer (m-X) Zmacs command 230 


Evaluate Changed Definitions of 


Buffer (m-X) Zmacs command 230 


Evaluate Into 


Buffer (m-X) Zmacs command 230 


Execute Command Into 


Buffer (m-X) Zmacs command 136 


Format 


Buffer (m-X) Zmacs command 35, 42 


Hardcopy 


Buffer (m-X) Zmacs command 136 


Insert 


Buffer (m-X) Zmacs command 141 


List Changed Definitions of 


Buffer (m-X) Zmacs command 239 


Rename 


Buffer (m-X) Zmacs command 136 


Revert 


Buffer (m-X) Zmacs command 138 


Show 


Buffer (m-X) Zmacs command 135 




Buffer pointers 1 00 




Buffers 32 


Association of files with 


buffers 32 


Changing 


Buffers 133 


Commands to Mark Regions by 


Buffers 107 


Destroying 


Buffers 139 


Editing 


Buffers 134 


Example of Listing 


Buffers 134 


File 


buffers 139 


List 


Buffers 134 


Listing 


Buffers 133 


Multiple 


buffers 130 


Possibility 


Buffers 126 


Reverting 


buffers 138,139 


Saving 


Buffers 136 


Selecting, Listing, and Examining Zmacs 


Buffers 132 


Support 


Buffers 126 


Zmacs Commands for Finding Out About the State of 


Buffers 278 


Creating and Saving 


Buffers and Files 32 


Description of Creating and Saving 


Buffers and Files 32 


Summary of Creating and Saving 


Buffers and Files 32 


Manipulating 


Buffers and Files in Zmacs 129 


Overview of Working with 


Buffers and Files in Zmacs 130 


Working with 


Buffers and Files in Zmacs 130 


Getting Information About 


Buffers and Regions 61 


Init File Form: Putting 


Buffers Into Current Package 272 


Changing Case of 


Buffers in Zmacs 21 4 


Comparing Files and 


Buffers in Zmacs 1 42 


Edit 


Buffers (m-X) Zmacs command 134 


Init File Form: Edit 


Buffers on c-X c-B 274 
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Init File Form: Edit 

Mode Line's 

Association of 

List 



Buffers on m-X 275 
Buffer-status 22 
buffers with files 32 
Buffers Zmacs command 131 
Built-in Customization Using Zmacs Minor 
Modes 253 



HELP 
SELECT 
Selecting a FED Ciiaracter with the 



HELP 



c-X 
HELP or 
c-X 
Init File Form: Edit Buffers on c-X 



c-X 



c-X 
Buffer Contents with c-X 



c-X 



c-X 
c-X 



c-X 



Init File Form: 



C 51 

C 44 

C Command 298 

C Dired command 1 69 

C Font Editor command 298, 330 

C Zmacs command 14, 52 

c-% Zmacs command 118 

c-/ completion command 15 

c-B c-m-Y 86 

c-8 c-m-Y yank command 15 

c-0 c-Y 85 

c- ; Zmacs command 226 

c- ; Zmacs command 228 

c-= Zmacs command 54 

C-? 15 

C-? completion command 15 

c-A Add Mode Word Abbrev 200 

c-A Zmacs command 28, 74, 95 

c-B 274 

c-B Zmacs command 28, 72 

c-B Zmacs command 131, 134 

c-C Font Editor command 329 

c-D Dired command 170 

c-D Zmacs command 30, 49, 90 

c-D Zmacs command 149 

c-E Zmacs command 28, 74, 95 

c-F 33 

c-F Zmacs command 28, 72 

c-F Zmacs command 33, 34 

c-G Zmacs command 48 

c-HELP V Zmacs command 269 

c-I Zmacs command 220 

c-J Change Style Character 21 

c-J Change Style Region 210 

c-K Dired command 170 

c-K Zmacs command 30, 95 

c-L Zmacs command 65 

c-L Zmacs command 214 

c-m- ( Zmacs command 77 

c-m-) Zmacs command 77 

c-m- ; Zmacs command 226 

c-m-? V Zmacs command 269 

c-m-@ Zmacs command 106 

c-m-A Zmacs command 78 

c-m-B Zmacs command 76 

c-m-D Zmacs command 77 

c-m-E Zmacs command 78 

c-m-F Zmacs command 76 

c-m-H Zmacs command 1 06 

c-m- J Change Typein Style 211 

c-m-K Zmacs command 30, 93 

c-m-L on the SQUARE Key 274 
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c-X 



Kill Backward Up List ( 

c-e 

c-B 



c-m-L Zmacs cxjmmand 133 
c-X c-m-L Zmacs command 133 

c-m-N Zmacs command 76 

c-m-0 Zmacs command 221 

c-m-P Zmacs command 76 

c-m-Q Zmacs command 219 

c-m-R Zmacs command 66 

c-m-RUBOUT Zmacs command 30, 93 

c-m-sh-E Zmacs command 230 

c-m-SPACE Zmacs command 102 

c-m -SPACE Zmacs command 102 

c-tn-T Zmacs command 93 

c-m-U Zmacs command 77 

c-m-V Zmacs command 147 

c-m-X 7 

c-tn-X) Zmacs command 93 

c-m-Y 86 

c-m-Y yank command 15 

c-m-Y yank command 15 

c-m-Z Zmacs command 230 

c-m- [ Zmacs command 78 

c-m-\ Zmacs command 219 

c-m-] Zmacs command 78 

c-m-" Zmacs command 220 

c-N DIred command 1 68 

c-N Zmacs command 28, 74, 95, 257 
c-X c-N Zmacs command 75 

c-0 c-Y yank command 15 

c-0 Zmacs command 221 
c-X c-0 Zmacs command 30, 221 

c-P DIred command 1 68 

c-P Zmacs command 28, 74, 95 
c-X c-P Zmacs command 107 

c-R Font Editor command 329 

c-REFRESH Font Editor command 330 
c-X c-S Zmacs command 34, 138 

c-sh-A Zmacs command 55 

c-sh-C Zmacs command 109 

c-sh-D Zmacs command 55 

c-sh-E Zmacs command 230 

c-sh-U Zmacs command 55 

c-sh-Y string-matching yank command 87 

c-SPACE Zmacs command 102 

c-T Zmacs command 90 
c-X c-T Zmacs command 96 

c-U Zmacs command 26 
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